@effindomv2/fui-as 0.1.37 → 0.1.39

package/browser/src/common-harness/text-session-bridge.ts

@@ -1,452 +0,0 @@
-import type { BridgeRuntime, WasmHandleLike } from '@effindomv2/runtime';
-
-import { currentInteractionTimeMs, toBigIntHandle, toNumberHandle, zeroPointer, normalizePointer, type AppHandleLike } from './interop';
-
-const decoder = new TextDecoder();
-const encoder = new TextEncoder();
-const TEXTBOX_HARD_CLAMP_MAX_CODEPOINTS = 10000;
-
-interface TextClampRange {
-  readonly start: number;
-  readonly end: number;
-}
-
-function advanceCodeUnitIndex(text: string, index: number): number {
-  const codePoint = text.codePointAt(index) ?? 0;
-  return index + (codePoint > 0xffff ? 2 : 1);
-}
-
-function isLineBreakCodeUnit(text: string, index: number): boolean {
-  if (index < 0 || index >= text.length) {
-    return false;
-  }
-  const codeUnit = text.charCodeAt(index);
-  return codeUnit === 0x0a || codeUnit === 0x0d;
-}
-
-function collectTextboxHardLineClampRanges(text: string): readonly TextClampRange[] {
-  const ranges: TextClampRange[] = [];
-  let index = 0;
-  while (index < text.length) {
-    let lineCapEnd = index;
-    let lineEnd = index;
-    let codePointCount = 0;
-    while (lineEnd < text.length && !isLineBreakCodeUnit(text, lineEnd)) {
-      const next = advanceCodeUnitIndex(text, lineEnd);
-      if (codePointCount < TEXTBOX_HARD_CLAMP_MAX_CODEPOINTS) {
-        lineCapEnd = next;
-      }
-      codePointCount += 1;
-      lineEnd = next;
-    }
-    if (codePointCount > TEXTBOX_HARD_CLAMP_MAX_CODEPOINTS) {
-      ranges.push({ start: lineCapEnd, end: lineEnd });
-    }
-    if (lineEnd >= text.length) {
-      break;
-    }
-    if (text.charCodeAt(lineEnd) === 0x0d && lineEnd + 1 < text.length && text.charCodeAt(lineEnd + 1) === 0x0a) {
-      index = lineEnd + 2;
-    } else {
-      index = lineEnd + 1;
-    }
-  }
-  return ranges;
-}
-
-function mapClampedTextIndex(index: number, ranges: readonly TextClampRange[]): number {
-  const clampedIndex = Math.max(0, index);
-  let removedBefore = 0;
-  for (const range of ranges) {
-    if (clampedIndex <= range.start) {
-      break;
-    }
-    if (clampedIndex < range.end) {
-      return range.start - removedBefore;
-    }
-    removedBefore += range.end - range.start;
-  }
-  return clampedIndex - removedBefore;
-}
-
-function clampTextboxHardLines(text: string): {
-  readonly text: string;
-  mapIndex(index: number): number;
-} {
-  const ranges = collectTextboxHardLineClampRanges(text);
-  if (ranges.length === 0) {
-    return {
-      text,
-      mapIndex: (index: number) => Math.max(0, Math.min(index, text.length)),
-    };
-  }
-  let result = '';
-  let cursor = 0;
-  for (const range of ranges) {
-    result += text.slice(cursor, range.start);
-    cursor = range.end;
-  }
-  result += text.slice(cursor);
-  return {
-    text: result,
-    mapIndex: (index: number) => mapClampedTextIndex(index, ranges),
-  };
-}
-
-function computeReplacementEdit(previousText: string, nextText: string): {
-  readonly start: number;
-  readonly end: number;
-  readonly insertedText: string;
-} | null {
-  if (previousText === nextText) {
-    return null;
-  }
-
-  const sharedPrefixLimit = Math.min(previousText.length, nextText.length);
-  let prefix = 0;
-  while (prefix < sharedPrefixLimit && previousText.charCodeAt(prefix) === nextText.charCodeAt(prefix)) {
-    prefix += 1;
-  }
-
-  let suffix = 0;
-  while (
-    suffix < (previousText.length - prefix) &&
-    suffix < (nextText.length - prefix) &&
-    previousText.charCodeAt(previousText.length - suffix - 1) === nextText.charCodeAt(nextText.length - suffix - 1)
-  ) {
-    suffix += 1;
-  }
-
-  return {
-    start: prefix,
-    end: previousText.length - suffix,
-    insertedText: nextText.slice(prefix, nextText.length - suffix),
-  };
-}
-
-function applyReplacementEdit(text: string, start: number, end: number, insertedText: string): string {
-  const clampedStart = Math.max(0, Math.min(start, text.length));
-  const clampedEnd = Math.max(clampedStart, Math.min(end, text.length));
-  return `${text.slice(0, clampedStart)}${insertedText}${text.slice(clampedEnd)}`;
-}
-
-function getHiddenTextEditor(): HTMLInputElement | HTMLTextAreaElement | null {
-  const activeElement = document.activeElement;
-  if (
-    (activeElement instanceof HTMLInputElement || activeElement instanceof HTMLTextAreaElement) &&
-    activeElement.dataset.effindomHiddenEditor === 'true'
-  ) {
-    return activeElement;
-  }
-  const editor = document.querySelector('input[data-effindom-hidden-editor="true"], textarea[data-effindom-hidden-editor="true"]');
-  return editor instanceof HTMLInputElement || editor instanceof HTMLTextAreaElement ? editor : null;
-}
-
-export interface TextSessionLike {
-  readonly memory: WebAssembly.Memory;
-  readonly textBufferPtr: number;
-  readonly textBufferSize: number;
-}
-
-interface FrozenTextSelectionSnapshot {
-  readonly handleKey: string;
-  readonly text: string;
-  readonly start: number;
-  readonly end: number;
-}
-
-export class TextSessionBridge {
-  private readonly latestTextByHandle = new Map<string, string>();
-  private readonly latestSelectionByHandle = new Map<string, { start: number; end: number }>();
-  private frozenTextSelectionSnapshot: FrozenTextSelectionSnapshot | null = null;
-
-  constructor(
-    private readonly getRuntime: () => BridgeRuntime,
-    private readonly getCurrentMemory: () => WebAssembly.Memory,
-    private readonly queueHarnessFrame: () => void,
-  ) {}
-
-  clearState(): void {
-    this.latestTextByHandle.clear();
-    this.latestSelectionByHandle.clear();
-    this.frozenTextSelectionSnapshot = null;
-  }
-
-  readAppUtf8(ptr: number, len: number): string {
-    if (len === 0) {
-      return '';
-    }
-    return decoder.decode(new Uint8Array(this.getCurrentMemory().buffer, ptr, len));
-  }
-
-  readAppFloats(ptr: number, count: number): Float32Array {
-    if (count === 0) {
-      return new Float32Array(0);
-    }
-    return new Float32Array(this.getCurrentMemory().buffer.slice(ptr, ptr + (count * 4)));
-  }
-
-  readAppBytes(ptr: number, len: number): Uint8Array {
-    if (len === 0) {
-      return new Uint8Array(0);
-    }
-    return new Uint8Array(this.getCurrentMemory().buffer.slice(ptr, ptr + len));
-  }
-
-  readAppTextParts(ptr: number, len: number): string[] {
-    if (len === 0) {
-      return [];
-    }
-    const source = new Uint8Array(this.getCurrentMemory().buffer, ptr, len);
-    if (source.byteLength < 4) {
-      throw new Error('Fetch request header payload was truncated.');
-    }
-    const dataView = new DataView(source.buffer, source.byteOffset, source.byteLength);
-    let byteOffset = 0;
-    const count = dataView.getUint32(byteOffset, true);
-    byteOffset += 4;
-    const values: string[] = [];
-    for (let index = 0; index < count; index += 1) {
-      if (byteOffset + 4 > source.byteLength) {
-        throw new Error('Fetch request header length was truncated.');
-      }
-      const partLen = dataView.getUint32(byteOffset, true);
-      byteOffset += 4;
-      if (byteOffset + partLen > source.byteLength) {
-        throw new Error('Fetch request header value was truncated.');
-      }
-      values.push(partLen > 0 ? decoder.decode(source.subarray(byteOffset, byteOffset + partLen)) : '');
-      byteOffset += partLen;
-    }
-    return values;
-  }
-
-  writeAppFloat32(ptr: number, value: number): void {
-    const appView = new DataView(this.getCurrentMemory().buffer);
-    appView.setFloat32(ptr, value, true);
-  }
-
-  writeAppUint32(ptr: number, value: number): void {
-    const appView = new DataView(this.getCurrentMemory().buffer);
-    appView.setUint32(ptr, value >>> 0, true);
-  }
-
-  writeAppUtf8(ptr: number, capacity: number, text: string, context: string): number {
-    if (capacity <= 0) {
-      if (text.length === 0) {
-        return 0;
-      }
-      throw new Error(`${context} cannot write into a zero-length host-service buffer.`);
-    }
-    const encoded = encoder.encode(text);
-    if (encoded.length > capacity) {
-      throw new Error(`${context} exceeds the provided host-service buffer.`);
-    }
-    if (encoded.length > 0) {
-      const memory = new Uint8Array(this.getCurrentMemory().buffer, ptr, encoded.length);
-      memory.set(encoded);
-    }
-    return encoded.length;
-  }
-
-  writeTextCallbackPayload(session: TextSessionLike, text: string, context: string): number {
-    const encoded = encoder.encode(text);
-    if (encoded.length > session.textBufferSize) {
-      throw new Error(`${context} exceeds the shared AssemblyScript text buffer.`);
-    }
-    if (encoded.length > 0) {
-      const memory = new Uint8Array(session.memory.buffer, session.textBufferPtr, encoded.length);
-      memory.set(encoded);
-    }
-    return encoded.length;
-  }
-
-  writeWorkerTextCallbackPayload(session: TextSessionLike, text: string, context: string): number {
-    return this.writeTextCallbackPayload(session, text, context);
-  }
-
-  writeTextToSessionBuffer(session: TextSessionLike, text: string): number {
-    if (session.textBufferPtr === 0 || session.textBufferSize === 0) {
-      return 0;
-    }
-    const encoded = encoder.encode(text);
-    const length = Math.min(encoded.length, session.textBufferSize);
-    if (length > 0) {
-      const memory = new Uint8Array(session.memory.buffer, session.textBufferPtr, length);
-      memory.set(encoded.subarray(0, length));
-    }
-    return length;
-  }
-
-  withUiUtf8(
-    text: string,
-    callback: (ptr: WasmHandleLike | number, len: number) => void,
-  ): void {
-    const runtime = this.getRuntime();
-    if (text.length === 0) {
-      callback(zeroPointer(runtime), 0);
-      return;
-    }
-    const bytes = encoder.encode(text);
-    const ptr = runtime.ui._malloc(bytes.length);
-    const numericPtr = toNumberHandle(ptr);
-    runtime.ui.HEAPU8.set(bytes, numericPtr);
-    callback(normalizePointer(runtime, ptr), bytes.length);
-    runtime.ui._free(ptr);
-  }
-
-  withUiGridData(
-    values: Float32Array,
-    types: Uint8Array,
-    callback: (valuesPtr: WasmHandleLike | number, typesPtr: WasmHandleLike | number) => void,
-  ): void {
-    const runtime = this.getRuntime();
-    const valueBytes = new Uint8Array(values.buffer);
-    const valuePtr = valueBytes.length > 0 ? runtime.ui._malloc(valueBytes.length) : zeroPointer(runtime);
-    const valueNumericPtr = valueBytes.length > 0 ? toNumberHandle(valuePtr) : 0;
-    if (valueBytes.length > 0) {
-      runtime.ui.HEAPU8.set(valueBytes, valueNumericPtr);
-    }
-
-    const typePtr = types.length > 0 ? runtime.ui._malloc(types.length) : zeroPointer(runtime);
-    const typeNumericPtr = types.length > 0 ? toNumberHandle(typePtr) : 0;
-    if (types.length > 0) {
-      runtime.ui.HEAPU8.set(types, typeNumericPtr);
-    }
-
-    callback(normalizePointer(runtime, valuePtr), normalizePointer(runtime, typePtr));
-
-    if (types.length > 0) {
-      runtime.ui._free(typePtr);
-    }
-    if (valueBytes.length > 0) {
-      runtime.ui._free(valuePtr);
-    }
-  }
-
-  withUiGradientData(
-    offsets: Float32Array,
-    colors: Uint32Array,
-    callback: (offsetsPtr: WasmHandleLike | number, colorsPtr: WasmHandleLike | number) => void,
-  ): void {
-    const runtime = this.getRuntime();
-    const offsetBytes = new Uint8Array(offsets.buffer);
-    const offsetPtr = offsetBytes.length > 0 ? runtime.ui._malloc(offsetBytes.length) : zeroPointer(runtime);
-    const offsetNumericPtr = offsetBytes.length > 0 ? toNumberHandle(offsetPtr) : 0;
-    if (offsetBytes.length > 0) {
-      runtime.ui.HEAPU8.set(offsetBytes, offsetNumericPtr);
-    }
-
-    const colorBytes = new Uint8Array(colors.buffer);
-    const colorPtr = colorBytes.length > 0 ? runtime.ui._malloc(colorBytes.length) : zeroPointer(runtime);
-    const colorNumericPtr = colorBytes.length > 0 ? toNumberHandle(colorPtr) : 0;
-    if (colorBytes.length > 0) {
-      runtime.ui.HEAPU8.set(colorBytes, colorNumericPtr);
-    }
-
-    callback(normalizePointer(runtime, offsetPtr), normalizePointer(runtime, colorPtr));
-
-    if (colorBytes.length > 0) {
-      runtime.ui._free(colorPtr);
-    }
-    if (offsetBytes.length > 0) {
-      runtime.ui._free(offsetPtr);
-    }
-  }
-
-  recordTextChanged(handle: AppHandleLike, text: string): void {
-    this.latestTextByHandle.set(toBigIntHandle(handle).toString(), text);
-  }
-
-  recordTextReplaced(handle: AppHandleLike, start: number, end: number, text: string): void {
-    const handleKey = toBigIntHandle(handle).toString();
-    const previousText = this.latestTextByHandle.get(handleKey) ?? '';
-    this.latestTextByHandle.set(handleKey, applyReplacementEdit(previousText, start, end, text));
-  }
-
-  recordSelectionChanged(handle: AppHandleLike, start: number, end: number): void {
-    this.latestSelectionByHandle.set(toBigIntHandle(handle).toString(), { start, end });
-  }
-
-  getLatestText(handle: AppHandleLike): string {
-    return this.latestTextByHandle.get(toBigIntHandle(handle).toString()) ?? '';
-  }
-
-  resolveFrozenOrLiveTextSelection(handle: AppHandleLike): FrozenTextSelectionSnapshot | null {
-    const handleKey = toBigIntHandle(handle).toString();
-    if (
-      this.frozenTextSelectionSnapshot !== null &&
-      this.frozenTextSelectionSnapshot.handleKey === handleKey &&
-      this.frozenTextSelectionSnapshot.start !== this.frozenTextSelectionSnapshot.end
-    ) {
-      return this.frozenTextSelectionSnapshot;
-    }
-    const text = this.latestTextByHandle.get(handleKey) ?? '';
-    const selection = this.latestSelectionByHandle.get(handleKey) ?? null;
-    if (selection === null || selection.start === selection.end || text.length === 0) {
-      return null;
-    }
-    const start = Math.max(0, Math.min(selection.start, selection.end));
-    const end = Math.max(start, Math.min(text.length, Math.max(selection.start, selection.end)));
-    return { handleKey, text, start, end };
-  }
-
-  freezeTextSelectionSnapshot(handle: AppHandleLike): void {
-    this.frozenTextSelectionSnapshot = this.resolveFrozenOrLiveTextSelection(handle);
-  }
-
-  clearFrozenTextSelectionSnapshot(): void {
-    this.frozenTextSelectionSnapshot = null;
-  }
-
-  getHiddenTextEditor(): HTMLInputElement | HTMLTextAreaElement | null {
-    return getHiddenTextEditor();
-  }
-
-  syncEditableTextToRuntime(handle: AppHandleLike, text: string, caret: number): void {
-    const runtime = this.getRuntime();
-    const handleKey = toBigIntHandle(handle).toString();
-    const previousText = this.latestTextByHandle.get(handleKey) ?? '';
-    const replacement = computeReplacementEdit(previousText, text);
-    if (replacement === null) {
-      runtime.commitFrame();
-      this.queueHarnessFrame();
-      return;
-    }
-    const intendedText =
-      `${previousText.slice(0, replacement.start)}${replacement.insertedText}${previousText.slice(replacement.end)}`;
-    const intendedCaret = Math.max(0, Math.min(caret, intendedText.length));
-    const clamped = clampTextboxHardLines(intendedText);
-    const committedText = clamped.text;
-    const clampedCaret = clamped.mapIndex(intendedCaret);
-    const editor = getHiddenTextEditor();
-    if (editor !== null && editor.value !== committedText) {
-      editor.value = committedText;
-      editor.setSelectionRange(clampedCaret, clampedCaret, 'none');
-    }
-    const committedReplacement = computeReplacementEdit(previousText, committedText);
-    if (committedReplacement === null) {
-      runtime.commitFrame();
-      this.queueHarnessFrame();
-      return;
-    }
-    runtime.ui._ui_set_interaction_time(currentInteractionTimeMs());
-    this.withUiUtf8(committedReplacement.insertedText, (uiPtr, uiLen) => {
-      runtime.ui._ui_replace_text_range(
-        toBigIntHandle(handle),
-        committedReplacement.start,
-        committedReplacement.end,
-        uiPtr,
-        uiLen,
-        clampedCaret,
-      );
-    });
-    runtime.commitFrame();
-    this.queueHarnessFrame();
-  }
-
-  updateLiveTextAfterCut(handleKey: string, text: string, caret: number): void {
-    this.latestTextByHandle.set(handleKey, text);
-    this.latestSelectionByHandle.set(handleKey, { start: caret, end: caret });
-  }
-}

package/browser/src/common-harness/types.ts

@@ -1,206 +0,0 @@
-import type { BridgeRuntime, EffinDomRuntimeConfig, WasmHandleLike } from '@effindomv2/runtime';
-
-import type { HostEventsDefinition } from '../host-events';
-import type { HostServicesDefinition } from '../host-services';
-import type { WorkerHostServicesBundleConfig } from '../worker-types';
-
-export interface HarnessState {
-  readonly commandWordCount: number;
-  readonly commandWords: readonly number[];
-  readonly rootHandle: string | null;
-}
-
-export interface HarnessExports {
-  readonly memory: WebAssembly.Memory;
-  __flushRenders(): void;
-  __fui_capture_persisted_ui_state?(): void;
-  __fui_debug_pointer_event?(eventType: number, handle: bigint, x: number, y: number, modifiers: number): void;
-  __fui_debug_focus_changed?(handle: bigint, focused: boolean): void;
-  __fui_debug_key_event?(eventType: number, keyPtr: number, keyLen: number, modifiers: number): void;
-  __fui_debug_scroll?(
-    handle: bigint,
-    offsetX: number,
-    offsetY: number,
-    contentWidth: number,
-    contentHeight: number,
-    viewportWidth: number,
-    viewportHeight: number,
-  ): void;
-  __fui_on_pointer_event(eventType: number, handle: bigint, x: number, y: number, modifiers: number): void;
-  __fui_on_external_drag_event(
-    eventType: number,
-    handle: bigint,
-    x: number,
-    y: number,
-    modifiers: number,
-    payloadPtr: number,
-    payloadLen: number,
-  ): number;
-  __fui_on_fetch_complete(
-    requestId: number,
-    ok: boolean,
-    status: number,
-    payloadPtr: number,
-    payloadLen: number,
-  ): void;
-  __fui_on_fetch_error(requestId: number, payloadPtr: number, payloadLen: number): void;
-  __fui_on_file_pick_result(requestId: number, status: number, payloadPtr: number, payloadLen: number): void;
-  __fui_on_file_read_result(
-    requestId: number,
-    status: number,
-    offsetBytes: bigint,
-    fileSizeBytes: bigint,
-    payloadPtr: number,
-    payloadLen: number,
-  ): void;
-  __fui_on_file_save_result(
-    requestId: number,
-    status: number,
-    writtenBytes: bigint,
-    payloadPtr: number,
-    payloadLen: number,
-  ): void;
-  __fui_on_file_writer_created(requestId: number, status: number, payloadPtr: number, payloadLen: number): void;
-  __fui_on_file_write_result(
-    requestId: number,
-    status: number,
-    writtenBytes: bigint,
-    totalWrittenBytes: bigint,
-    payloadPtr: number,
-    payloadLen: number,
-  ): void;
-  __fui_on_file_finish_result(
-    requestId: number,
-    status: number,
-    writtenBytes: bigint,
-    payloadPtr: number,
-    payloadLen: number,
-  ): void;
-  __fui_on_file_worker_process_progress(
-    requestId: number,
-    copiedBytes: bigint,
-    totalBytes: bigint,
-    payloadPtr: number,
-    payloadLen: number,
-  ): void;
-  __fui_on_file_worker_process_chunk(
-    requestId: number,
-    offsetBytes: bigint,
-    fileSizeBytes: bigint,
-    payloadPtr: number,
-    payloadLen: number,
-  ): void;
-  __fui_on_file_worker_process_complete(
-    requestId: number,
-    writtenBytes: bigint,
-    payloadPtr: number,
-    payloadLen: number,
-  ): void;
-  __fui_on_file_worker_process_error(requestId: number, status: number, payloadPtr: number, payloadLen: number): void;
-  __fui_on_context_menu(handle: bigint, x: number, y: number): void;
-  __fui_hide_active_context_menu(): void;
-  __fui_key_buffer(): number;
-  __fui_text_buffer(): number;
-  __fui_text_buffer_size(): number;
-  __fui_on_focus_changed(handle: bigint, focused: boolean): void;
-  __fui_on_text_changed(handle: bigint, textPtr: number, textLen: number): void;
-  __fui_on_text_replaced(handle: bigint, start: number, end: number, textPtr: number, textLen: number): void;
-  __fui_on_selection_changed(handle: bigint, start: number, end: number): void;
-  __fui_on_key_event(eventType: number, keyPtr: number, keyLen: number, modifiers: number): number;
-  __fui_on_scroll(
-    handle: bigint,
-    offsetX: number,
-    offsetY: number,
-    contentWidth: number,
-    contentHeight: number,
-    viewportWidth: number,
-    viewportHeight: number,
-  ): void;
-  __fui_on_cross_selection_changed(handle: bigint, textPtr: number, textLen: number): void;
-  __fui_on_route_changed(routePtr: number, routeLen: number): void;
-  __fui_on_viewport_changed(width: number, height: number): void;
-  __fui_on_system_dark_mode_changed(isDark: boolean): void;
-  __fui_on_svg_loaded(svgId: number, width: number, height: number): void;
-  __fui_on_svg_failed(svgId: number, errorPtr: number, errorLen: number): void;
-  __fui_on_texture_loaded(textureId: number, width: number, height: number): void;
-  __fui_on_texture_failed(textureId: number, errorPtr: number, errorLen: number): void;
-  __fui_on_frame(timestampMs: number): void;
-  __fui_on_timer(timerId: number): void;
-  __fui_on_worker_progress(workerId: number, textPtr: number, textLen: number): void;
-  __fui_on_worker_complete(workerId: number, textPtr: number, textLen: number): void;
-  __fui_on_worker_error(workerId: number, textPtr: number, textLen: number): void;
-  __fui_restore_persisted_ui_state?(): void;
-  fui_dispatch_custom_draw?(handle: bigint, canvasPtr: number): void;
-}
-
-export interface HarnessContext<Exports extends HarnessExports> {
-  readonly runtime: BridgeRuntime;
-  readonly exports: Exports;
-  waitForFrame(): Promise<void>;
-}
-
-export interface HarnessOptions<Exports extends HarnessExports> {
-  wasmPath: string;
-  run?(exports: Exports): void;
-  onStateUpdated?(state: HarnessState): void;
-  onReady?(context: HarnessContext<Exports>): void | Promise<void>;
-  onDispose?(exports: Exports): void;
-  onError?(error: unknown): void;
-  showLoadingOverlay?: boolean;
-  hostEvents?: HostEventsDefinition;
-  hostServices?: HostServicesDefinition;
-  workerHostServices?: WorkerHostServicesBundleConfig;
-  persistedRestoreMode?: 'initial' | 'pop' | 'none';
-}
-
-export interface HarnessAppOptions<Exports extends HarnessExports> extends HarnessOptions<Exports> {
-  run(exports: Exports): void;
-}
-
-export type HarnessNavigationMode = 'push' | 'replace' | 'pop';
-
-export interface HarnessController {
-  readonly runtime: BridgeRuntime;
-  waitForFrame(): Promise<void>;
-  loadApp<Exports extends HarnessExports>(options: HarnessAppOptions<Exports>): Promise<HarnessContext<Exports>>;
-  unloadApp(): Promise<void>;
-  recreateRuntime(): Promise<BridgeRuntime>;
-  setSameOriginNavigationHandler(
-    handler: ((target: URL, mode: HarnessNavigationMode) => void | Promise<void>) | null,
-  ): void;
-}
-
-export interface ManagedHarnessOptions {
-  onReady?(controller: HarnessController): void | Promise<void>;
-  onError?(error: unknown): void;
-}
-
-export interface ManagedHistoryState {
-  readonly href: string;
-  readonly uiSnapshotId?: string;
-}
-
-export interface HarnessDebugApi {
-  flush(): Promise<void>;
-  pointerEvent(type: number, handle: WasmHandleLike, x: number, y: number, modifiers?: number): Promise<void>;
-  focusChanged(handle: WasmHandleLike, focused: boolean): Promise<void>;
-  keyEvent(type: number, key: string, modifiers?: number): Promise<void>;
-  navigateTo(target: string): Promise<void>;
-  scroll(
-    handle: WasmHandleLike,
-    offsetX: number,
-    offsetY: number,
-    contentWidth: number,
-    contentHeight: number,
-    viewportWidth: number,
-    viewportHeight: number,
-  ): Promise<void>;
-}
-
-declare global {
-  interface Window {
-    __effindomRuntime?: EffinDomRuntimeConfig;
-    __fui_debug?: HarnessDebugApi;
-    __fuiUrlPreviewText?: string;
-  }
-}