peachsim 0.1.1644 → 0.1.1653

package/dist-types/packages/peach-engine/src/render-worker/native-ui-protocol.d.ts

@@ -0,0 +1,1087 @@
+import { type NativeUICommand } from './native-ui-commandContract.d.ts';
+import type { NativePhotoLibraryRequest, NativePhotoLibraryChange, NativePhotoLibraryResult } from '../ios/photoLibraryContract.d.ts';
+import type { AppPreferenceValue, AppSettingsSnapshot, SystemPermissionApp, SystemPermissionMutation, SystemPermissionRequestContext } from '../permissions/system-permission-types.d.ts';
+import type { AuxAppSurfaceId } from './aux-surface-types.d.ts';
+import type { OneNativeContentPublication } from './one-native-contentContract.d.ts';
+import type { SystemNotificationSettings, SystemPermissionDescriptor, SystemPermissionLocationAccuracy, SystemPermissionState } from '../../../peach-compat/src/engine-config.d.ts';
+import type { SootSimWebViewCookieStore, SootSimImageCropperSpec, SootSimAndroidDateTimePickerResult, SootSimAndroidDateTimePickerSpec, SootSimImagePickerOptions, SootSimPhotoLibraryAsset, SootSimPhotoLibraryPage, SootsimSettingsRoute, SootSimWebViewNavigationType, PeachWebViewDocumentData, SootSimWebKitConfiguration, SootSimWebKitEvent, SootSimWebKitReply, NativeSurfacePresentation } from '../../../peach-globals/src/index.d.ts';
+export type KeyboardMode = 'letters' | 'numbers' | 'symbols' | 'numeric' | 'emoji';
+export type IOSKeyboardType = 'default' | 'ascii-capable' | 'numbers-and-punctuation' | 'url' | 'number-pad' | 'ascii-capable-number-pad' | 'phone-pad' | 'name-phone-pad' | 'email-address' | 'decimal-pad' | 'twitter' | 'web-search' | 'visible-password' | 'numeric';
+export type ReturnKeyType = 'default' | 'continue' | 'done' | 'go' | 'join' | 'next' | 'route' | 'search' | 'send';
+export type AutoCapitalizeMode = 'none' | 'sentences' | 'words' | 'characters';
+export type KeyboardAppearance = 'default' | 'light' | 'dark';
+export interface KeyboardFrameSnapshot {
+    screenX: number;
+    screenY: number;
+    width: number;
+    height: number;
+}
+export interface KeyboardLayoutSnapshot {
+    visible: boolean;
+    spec: KeyboardShowSpec | null;
+    mode: KeyboardMode;
+    shifted: boolean;
+    capsLock: boolean;
+    accessoryBarId: string | null;
+    frame: KeyboardFrameSnapshot;
+}
+export interface HostKeyboardFrame extends KeyboardFrameSnapshot {
+    phase: 'start' | 'end';
+    duration: number;
+}
+export declare function readHostKeyboardFrame(value: unknown): HostKeyboardFrame | null;
+export interface KeyboardAnimationFrameSnapshot {
+    phase: 'start' | 'move' | 'end';
+    source: 'physical' | 'focus';
+    transitionId: number;
+    targetVisible: boolean;
+    platform: 'ios' | 'android';
+    cancelled: boolean;
+    height: number;
+    progress: number;
+    duration: number;
+    visible: boolean;
+    targetHeight: number;
+    accessoryOffset: number;
+}
+export declare function controllerVisibleKeyboardHeight(frame: {
+    phase: KeyboardAnimationFrameSnapshot['phase'];
+    targetVisible: boolean;
+    height: number;
+    progress: number;
+    targetHeight: number;
+    accessoryOffset: number;
+}): {
+    height: number;
+    progress: number;
+};
+export interface KeyboardCandidate {
+    text: string;
+    start: number;
+    end: number;
+}
+export interface KeyboardShowSpec {
+    keyboardType: IOSKeyboardType;
+    returnKeyType: ReturnKeyType;
+    secureTextEntry: boolean;
+    showPasswordAutofillBar: boolean;
+    enablesReturnKeyAutomatically: boolean;
+    autoCapitalize: AutoCapitalizeMode;
+    autoCorrect: boolean;
+    spellCheck: boolean;
+    keyboardAppearance: KeyboardAppearance;
+    accessoryBarId: string | null;
+    currentTextIsEmpty: boolean;
+    currentText: string;
+    selectionStart: number;
+    selectionEnd: number;
+    accessoryOffset: number;
+}
+export declare const DEFAULT_KEYBOARD_SHOW_SPEC: KeyboardShowSpec;
+export interface FocusedInputLayout {
+    target: number;
+    parentScrollViewTarget: number;
+    layout: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        absoluteX: number;
+        absoluteY: number;
+    };
+    selection: {
+        start: {
+            x: number;
+            y: number;
+            position: number;
+        };
+        end: {
+            x: number;
+            y: number;
+            position: number;
+        };
+    };
+}
+export interface AlertButtonSpec {
+    text?: string;
+    style?: 'default' | 'cancel' | 'destructive';
+    isPreferred?: boolean;
+}
+export type AlertPromptValue = string | {
+    login: string;
+    password: string;
+};
+export interface AlertSpec {
+    title: string;
+    message?: string;
+    buttons?: AlertButtonSpec[];
+    cancelable?: boolean;
+    prompt?: {
+        defaultValue?: string;
+        keyboardType?: string;
+        type: 'default' | 'plain-text' | 'secure-text' | 'login-password';
+    };
+}
+export interface AuthSessionSpec {
+    title: string;
+    message?: string;
+    cancelText: string;
+}
+export interface ActionSheetSpec {
+    title?: string;
+    message?: string;
+    options: string[];
+    animated?: boolean;
+    permittedArrowDirections?: number;
+    disabledButtonIndices?: number[];
+    preferredButtonIndex?: number;
+    cancelButtonIndex?: number;
+    destructiveButtonIndex?: number | number[];
+    tintColor?: string;
+    datePicker?: DatePickerSpec;
+    sourceRect?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+export interface DatePickerSpec {
+    date: string;
+    mode?: 'date' | 'time' | 'datetime';
+    locale?: string;
+    minimumDate?: string;
+    maximumDate?: string;
+    minuteInterval?: number;
+    timeZoneOffsetInMinutes?: string | null;
+    textColor?: string;
+    theme?: 'light' | 'dark' | 'auto';
+}
+export interface AndroidToastSpec {
+    id: string;
+    message: string;
+    duration: number;
+    gravity: number;
+    xOffset: number;
+    yOffset: number;
+}
+export type AndroidPermissionStatus = 'granted' | 'denied' | 'never_ask_again';
+export interface AndroidPermissionPromptSpec {
+    permissions: string[];
+    title?: string;
+    message?: string;
+    appName?: string;
+}
+export type SystemPermissionOperation = {
+    kind: 'check';
+    app: SystemPermissionRequestContext;
+    permissions: readonly SystemPermissionDescriptor[];
+} | {
+    kind: 'request';
+    app: SystemPermissionRequestContext;
+    permissions: readonly SystemPermissionDescriptor[];
+} | {
+    kind: 'list-settings-apps';
+} | {
+    kind: 'get-app-settings';
+    appId: string;
+    platform: SystemPermissionRequestContext['platform'];
+} | {
+    kind: 'set-app-permission';
+    appId: string;
+    platform: SystemPermissionRequestContext['platform'];
+    permission: SystemPermissionDescriptor['kind'];
+    mutation: SystemPermissionMutation;
+} | {
+    kind: 'patch-notification-settings';
+    appId: string;
+    platform: SystemPermissionRequestContext['platform'];
+    patch: Partial<SystemNotificationSettings>;
+} | {
+    kind: 'set-app-declared-setting';
+    appId: string;
+    platform: SystemPermissionRequestContext['platform'];
+    key: string;
+    value: AppPreferenceValue;
+    callerStorageScopeUrl?: string;
+} | {
+    kind: 'request-location-accuracy';
+    app: SystemPermissionRequestContext;
+    purpose: string;
+} | {
+    kind: 'open-limited-photo-library-picker';
+    appId: string;
+} | {
+    kind: 'open-app-settings';
+    route: SootsimSettingsRoute;
+} | {
+    kind: 'reset-app-permissions';
+    appId: string;
+    platform: SystemPermissionRequestContext['platform'];
+};
+export type SystemPermissionOperationResult = {
+    kind: 'states';
+    states: readonly SystemPermissionState[];
+} | {
+    kind: 'settings-apps';
+    apps: readonly SystemPermissionApp[];
+} | {
+    kind: 'app-settings';
+    snapshot: AppSettingsSnapshot;
+} | {
+    kind: 'location-accuracy';
+    accuracy: SystemPermissionLocationAccuracy;
+} | {
+    kind: 'completed';
+} | {
+    kind: 'error';
+    message: string;
+};
+export interface NotificationSpec {
+    id: string;
+    appName: string;
+    title: string;
+    body: string;
+    iconColor?: string;
+    iconUri?: string;
+    iconName?: string;
+    openUrl?: string;
+    appId?: string;
+    time?: string;
+    actions?: NotificationActionSpec[];
+}
+export interface NotificationActionSpec {
+    id: string;
+    title: string;
+    destructive?: boolean;
+    foreground?: boolean;
+    textInput?: {
+        buttonTitle?: string;
+        placeholder?: string;
+    };
+}
+export interface BurntIconSpec {
+    name: string;
+    color?: string;
+}
+export interface BurntLayoutSpec {
+    iconSize?: {
+        width: number;
+        height: number;
+    };
+}
+export interface BurntToastSpec {
+    id: string;
+    title: string;
+    message?: string;
+    preset: 'done' | 'error' | 'none' | 'custom';
+    duration: number;
+    haptic: 'success' | 'warning' | 'error' | 'none';
+    shouldDismissByDrag: boolean;
+    from: 'top' | 'bottom';
+    layout?: BurntLayoutSpec;
+    icon?: BurntIconSpec;
+    backgroundColor?: string;
+    textColor?: string;
+    numberOfLines?: number;
+    textAlign?: 'left' | 'center' | 'right';
+    fontFamily?: string;
+    bottomOffset?: number;
+    interactiveRequestId?: number;
+    action?: {
+        text: string;
+        textColor?: string;
+    };
+}
+export interface BurntToastDismissSpec {
+    idPrefix: string;
+}
+export interface BurntAlertSpec {
+    id: string;
+    title: string;
+    message?: string;
+    preset: 'heart' | 'done' | 'error' | 'none' | 'spinner' | 'custom';
+    duration: number;
+    shouldDismissByTap: boolean;
+    layout?: BurntLayoutSpec;
+    icon?: BurntIconSpec;
+}
+export interface KeyRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface KeyboardPopupState {
+    label: string;
+    x: number;
+    y: number;
+    width: number;
+}
+export interface WebViewSourceSpec {
+    uri?: string;
+    html?: string;
+    baseUrl?: string;
+    headers?: Record<string, string>;
+    method?: string;
+    bodyBase64?: string;
+    documentData?: PeachWebViewDocumentData;
+}
+export interface WebViewSpec extends Partial<NativeSurfacePresentation> {
+    cookieStore?: SootSimWebViewCookieStore;
+    webKit?: SootSimWebKitConfiguration;
+    captureOwner?: {
+        surfaceId: string;
+        generation: number;
+    };
+    source?: WebViewSourceSpec;
+    injectedJavaScript?: string;
+    injectedJavaScriptBeforeContentLoaded?: string;
+    injectedJavaScriptObject?: string;
+    expoDomWebViewId?: number;
+    hasOnOpenWindowEvent?: boolean;
+    hasOnShouldStartLoadWithRequest?: boolean;
+    incognito?: boolean;
+    javaScriptEnabled?: boolean;
+    scrollEnabled?: boolean;
+    startInLoadingState?: boolean;
+    testID?: string;
+}
+export interface ImagePickerSpec extends SootSimImagePickerOptions {
+    source?: 'library' | 'camera';
+    title?: string;
+}
+export interface ImagePickerAssetSpec {
+    assetId?: string;
+    uri: string;
+    width: number;
+    height: number;
+    fileName?: string;
+    mimeType?: string;
+    fileSize?: number;
+    mediaType?: 'image' | 'video';
+    duration?: number;
+}
+export interface ImagePickerResultSpec {
+    continuing?: boolean;
+    canceled: boolean;
+    assets: ImagePickerAssetSpec[] | null;
+    error?: string;
+}
+export type ImageCropperSpec = SootSimImageCropperSpec;
+export interface ImageCropperResultSpec {
+    done: boolean;
+}
+export type AndroidDateTimePickerSpec = SootSimAndroidDateTimePickerSpec;
+export type AndroidDateTimePickerResultSpec = SootSimAndroidDateTimePickerResult;
+export interface ViewShotCaptureSpec {
+    owner?: import('../../../peach-globals/src/index.d.ts').ShellNativeEvaluationOwner;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    outputWidth?: number;
+    outputHeight?: number;
+    scale: number;
+    format: 'png' | 'jpg' | 'webp';
+    quality: number;
+    nodeTag?: number;
+    contentContainer?: boolean;
+    preserveViewSize?: boolean;
+    svgViewport?: boolean;
+}
+export interface ViewShotCaptureResultSpec {
+    dataUri: string | null;
+    width: number;
+    height: number;
+}
+export type ShareSheetItemResult = {
+    status: 'fulfilled';
+    url: string;
+} | {
+    status: 'rejected';
+};
+export interface ShareActivityItem {
+    type: 'text' | 'url' | 'file';
+    value: string;
+}
+export declare const COPY_ACTIVITY_TYPES: string[];
+export interface ShareSheetSpec {
+    presentationStyle?: 'popover';
+    receivingApps?: {
+        activityType: string;
+        name: string | null;
+        iconUrl?: string;
+    }[];
+    activityItems?: ShareActivityItem[];
+    itemProvider?: {
+        typeIdentifier: 'public.url';
+    };
+    preview?: {
+        title: string;
+        image: string;
+    };
+    suggestedMessage?: string;
+    title?: string;
+    dialogTitle?: string;
+    message?: string;
+    url?: string;
+    image?: {
+        uri: string;
+        kind: 'file' | 'bitmap';
+        scale?: number;
+        name?: string;
+        mimeType?: string;
+        sizeBytes?: number;
+    };
+    subject?: string;
+    excludedActivityTypes?: string[];
+}
+export declare function shareCopyText(spec: ShareSheetSpec): string | null;
+export declare function canShareCopy(spec: ShareSheetSpec): boolean;
+export interface ShareSheetResultSpec {
+    error?: string;
+    completed: boolean;
+    activityType: string | null;
+}
+export interface PhotoLibraryQuerySpec {
+    appId: string;
+    platform: 'ios' | 'android';
+    first: number;
+    after?: string;
+    assetType?: 'All' | 'Photos' | 'Videos';
+    readFiles?: boolean;
+}
+export type PhotoLibraryAssetSpec = SootSimPhotoLibraryAsset;
+export type PhotoLibraryPageSpec = SootSimPhotoLibraryPage;
+export interface PhotoLibraryCreateAssetSpec {
+    appId: string;
+    uri: string;
+    width?: number;
+    height?: number;
+    fileName?: string;
+    mediaType?: 'photo' | 'video';
+}
+export type AndroidSystemBarStyle = 'default' | 'light-content' | 'dark-content' | 'auto' | 'inverted' | 'light' | 'dark' | (string & {});
+export interface AndroidSystemBarState {
+    backgroundColor: string;
+    hidden: boolean;
+    style: AndroidSystemBarStyle;
+    translucent: boolean;
+}
+export interface AndroidNavigationBarState extends AndroidSystemBarState {
+    borderColor: string | null;
+    position: string | null;
+}
+export interface AndroidSystemBarsState {
+    behavior: string | null;
+    revealed: boolean;
+    statusBar: AndroidSystemBarState;
+    navigationBar: AndroidNavigationBarState;
+}
+export interface AndroidSystemBarPatch {
+    backgroundColor?: string;
+    hidden?: boolean;
+    style?: AndroidSystemBarStyle;
+    translucent?: boolean;
+    animation?: StatusBarUpdateAnimation;
+}
+export type StatusBarUpdateAnimation = 'none' | 'fade' | 'slide';
+export declare function readStatusBarUpdateAnimation(value: unknown): StatusBarUpdateAnimation;
+export interface AndroidNavigationBarPatch extends AndroidSystemBarPatch {
+    borderColor?: string | null;
+    position?: string | null;
+}
+export interface AndroidSystemBarsPatch {
+    behavior?: string | null;
+    statusBar?: AndroidSystemBarPatch;
+    navigationBar?: AndroidNavigationBarPatch;
+}
+export type NativeUIRequest = NativeUIRequestBody & {
+    remoteSurfaceId?: AuxAppSurfaceId;
+};
+export type HostNativeUIRequest = Extract<NativeUIRequest, {
+    kind: `webview.${string}` | 'systemBars.update';
+}>;
+export declare function isHostNativeUIRequest(request: NativeUIRequest): request is HostNativeUIRequest;
+export type NativeWidgetServiceRequest = Extract<NativeUIRequest, {
+    kind: 'systemPermission.perform';
+}> & {
+    operation: Extract<SystemPermissionOperation, {
+        kind: 'get-app-settings';
+    }>;
+};
+export declare function isNativeWidgetServiceRequest(request: NativeUIRequest): request is NativeWidgetServiceRequest;
+export interface AndroidBackCallbackRegistration {
+    priority: number;
+    registration: number;
+}
+export interface AndroidBackDialogWindow {
+    id: number;
+    callbacks: readonly AndroidBackCallbackRegistration[];
+}
+export interface AndroidBackWindowRequest {
+    kind: 'androidBack.window';
+    action: 'attach' | 'update' | 'detach';
+    appId: string;
+    windowId: string;
+    predictiveBackEnabled: boolean;
+    callbacks: readonly AndroidBackCallbackRegistration[];
+    dialogs: readonly AndroidBackDialogWindow[];
+}
+export interface AndroidBackPhaseEvent {
+    kind: 'androidBack.phase';
+    appId: string;
+    windowId: string;
+    receiverId: number;
+    registration: number;
+    phase: import('../platform/android-predictive-back.d.ts').AndroidPredictiveBackPhase;
+    touchX: number;
+    touchY: number;
+    progress: number;
+    swipeEdge: 0 | 1;
+    frameTimeMillis: number;
+}
+type NativeUIRequestBody = import('../capture/nativeScreenCaptureContract.d.ts').NativeScreenCaptureRequest | AndroidBackWindowRequest | {
+    kind: 'keyboard.hostFrame';
+    frame: HostKeyboardFrame;
+} | {
+    kind: 'keyboard.show';
+    spec: KeyboardShowSpec;
+    focusedInput: FocusedInputLayout | null;
+    traitScheme?: 'light' | 'dark' | null;
+} | {
+    kind: 'keyboard.update';
+    spec: KeyboardShowSpec;
+} | {
+    kind: 'keyboard.hide';
+    keepFocus?: boolean;
+} | {
+    kind: 'keyboard.preload';
+    requestId: number;
+} | {
+    kind: 'keyboard.setTranslucent';
+    translucent: boolean;
+} | {
+    kind: 'keyboard.interactiveBegin';
+    gestureId: number;
+    targetVisible: boolean;
+    keepFocus: boolean;
+} | {
+    kind: 'keyboard.interactiveUpdate';
+    gestureId: number;
+    deltaY: number;
+} | {
+    kind: 'keyboard.interactiveEnd';
+    gestureId: number;
+    velocityY: number | null;
+} | {
+    kind: 'keyboard.interactiveCancel';
+    gestureId: number;
+} | {
+    kind: 'keyboard.charTyped';
+    char: string;
+} | {
+    kind: 'keyboard.press';
+    key: string;
+} | {
+    kind: 'keyboard.dispatchRaw';
+    key: string;
+} | {
+    kind: 'keyboard.queryMode';
+    requestId: number;
+} | {
+    kind: 'keyboard.queryKeyRect';
+    requestId: number;
+    label: string;
+} | {
+    kind: 'keyboard.queryPopup';
+    requestId: number;
+} | {
+    kind: 'appIcon.attach';
+    name?: string;
+    owner: import('../../../peach-globals/src/index.d.ts').ShellNativeEvaluationOwner;
+    evaluationId: string;
+    artwork?: import('../../../../../src/nativeAppIconContract.ts').NativeAppIconArtwork;
+} | {
+    kind: 'appIcon.retire';
+    owner: import('../../../peach-globals/src/index.d.ts').ShellNativeEvaluationOwner;
+    evaluationId: string;
+} | {
+    kind: 'appIcon.perform';
+    owner: import('../../../peach-globals/src/index.d.ts').ShellNativeEvaluationOwner;
+    evaluationId: string;
+    requestId: number;
+    name?: string;
+} | {
+    kind: 'alert.show';
+    requestId: number;
+    spec: AlertSpec;
+    traitScheme?: 'light' | 'dark' | null;
+    owner?: import('../../../peach-compat/src/stubs/native-evaluation-lease.d.ts').ShellNativeEvaluationOwner;
+} | {
+    kind: 'alert.dismiss';
+    requestId: number;
+} | {
+    kind: 'nativeUI.command';
+    requestId: number;
+    presentationId: number;
+    command: NativeUICommand;
+} | {
+    kind: 'systemAlert.show';
+    requestId: number;
+    appId: string;
+    spec: AlertSpec;
+    settingsRoutes: readonly (SootsimSettingsRoute | null)[];
+} | {
+    kind: 'systemAlert.ownerEnded';
+    appId: string;
+} | {
+    kind: 'oneNativeContent.publish';
+    publication: OneNativeContentPublication;
+} | {
+    kind: 'authSession.show';
+    ownerId: string;
+    sessionId: number;
+    spec: AuthSessionSpec;
+} | {
+    kind: 'authSession.hide';
+    ownerId: string;
+    sessionId: number;
+} | {
+    kind: 'actionSheet.show';
+    requestId: number;
+    spec: ActionSheetSpec;
+    traitScheme?: 'light' | 'dark' | null;
+} | {
+    kind: 'actionSheet.dismiss';
+    requestId: number;
+} | {
+    kind: 'androidToast.show';
+    spec: AndroidToastSpec;
+} | {
+    kind: 'androidPermission.request';
+    requestId: number;
+    spec: AndroidPermissionPromptSpec;
+} | {
+    kind: 'systemPermission.perform';
+    requestId: number;
+    operation: SystemPermissionOperation;
+    owner?: import('../../../peach-globals/src/index.d.ts').ShellNativeEvaluationOwner;
+} | {
+    kind: 'systemPermission.dismiss';
+    requestId: number;
+    owner?: import('../../../peach-globals/src/index.d.ts').ShellNativeEvaluationOwner;
+} | {
+    kind: 'imagePicker.show';
+    requestId: number;
+    spec: ImagePickerSpec;
+    owner?: import('../../../peach-globals/src/index.d.ts').ShellNativeEvaluationOwner;
+} | {
+    kind: 'imagePicker.dismiss';
+    requestId: number;
+    owner?: import('../../../peach-globals/src/index.d.ts').ShellNativeEvaluationOwner;
+} | {
+    kind: 'imageCropper.show';
+    requestId: number;
+    spec: ImageCropperSpec;
+} | {
+    kind: 'androidDateTimePicker.show';
+    requestId: number;
+    spec: AndroidDateTimePickerSpec;
+} | {
+    kind: 'androidDateTimePicker.dismiss';
+    requestId: number;
+} | {
+    kind: 'shareSheet.show';
+    requestId: number;
+    spec: ShareSheetSpec;
+} | {
+    kind: 'shareSheet.itemResult';
+    requestId: number;
+    itemRequestId: number;
+    result: ShareSheetItemResult;
+} | {
+    kind: 'photoLibrary.query';
+    requestId: number;
+    spec: PhotoLibraryQuerySpec;
+} | NativePhotoLibraryRequest | {
+    kind: 'photoLibrary.createAsset';
+    requestId: number;
+    spec: PhotoLibraryCreateAssetSpec;
+} | {
+    kind: 'viewShot.capture';
+    requestId: number;
+    spec: ViewShotCaptureSpec;
+} | {
+    kind: 'devMenu.toggle';
+} | {
+    kind: 'devMenu.show';
+} | {
+    kind: 'devMenu.dismiss';
+} | {
+    kind: 'devMenu.reload';
+} | {
+    kind: 'notification.push';
+    spec: NotificationSpec;
+} | {
+    kind: 'safari.open';
+    url: string;
+} | {
+    kind: 'notification.dismiss';
+    id: string;
+    immediate?: boolean;
+} | {
+    kind: 'notification.remote-push';
+    payload: Record<string, unknown>;
+    launch: boolean;
+    actionId?: string;
+    userText?: string;
+} | {
+    kind: 'toolbar.safeArea';
+    bottomInset: number;
+} | {
+    kind: 'systemBars.update';
+    appId: string | null;
+    patch: AndroidSystemBarsPatch;
+} | {
+    kind: 'burnt.toast';
+    spec: BurntToastSpec;
+} | {
+    kind: 'burnt.dismissToasts';
+    spec: BurntToastDismissSpec;
+} | {
+    kind: 'burnt.alert';
+    spec: BurntAlertSpec;
+} | {
+    kind: 'burnt.dismissAllAlerts';
+} | {
+    kind: 'webview.mount';
+    instanceId: string;
+    spec: WebViewSpec;
+} | {
+    kind: 'webview.update';
+    instanceId: string;
+    spec: WebViewSpec;
+} | {
+    kind: 'webview.unmount';
+    instanceId: string;
+} | {
+    kind: 'webview.activate';
+    instanceId: string;
+    point?: {
+        x: number;
+        y: number;
+    };
+} | {
+    kind: 'webview.deactivate';
+    instanceId: string;
+} | {
+    kind: 'webview.evaluateJavaScript';
+    instanceId: string;
+    requestId: number;
+    js: string;
+    userAgent?: string;
+} | {
+    kind: 'webview.updateWebKitCookies';
+    instanceId: string;
+    requestId: number;
+    cookies: string;
+    policy: number;
+} | {
+    kind: 'webview.setMessageHandlers';
+    instanceId: string;
+    names: string[];
+} | {
+    kind: 'webview.replyScriptMessage';
+    instanceId: string;
+    requestId: number;
+    reply: SootSimWebKitReply;
+} | {
+    kind: 'webview.fileResponse';
+    instanceId: string;
+    requestId: number;
+    file: {
+        mimeType: string;
+        bytesBase64: string;
+    } | null;
+} | {
+    kind: 'webview.snapshot';
+    instanceId: string;
+    requestId: number;
+    rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    scale: number;
+} | {
+    kind: 'webview.injectJavaScript';
+    instanceId: string;
+    js: string;
+} | {
+    kind: 'webview.postMessage';
+    instanceId: string;
+    data: string;
+} | {
+    kind: 'webview.goBack';
+    instanceId: string;
+} | {
+    kind: 'webview.goForward';
+    instanceId: string;
+} | {
+    kind: 'webview.reload';
+    instanceId: string;
+} | {
+    kind: 'webview.stopLoading';
+    instanceId: string;
+    navigation?: number;
+} | {
+    kind: 'webview.shouldStartLoadDecision';
+    instanceId: string;
+    lockIdentifier: number;
+    shouldStart: boolean;
+};
+export type NativeUIEvent = import('../capture/nativeScreenCaptureContract.d.ts').NativeScreenCaptureSnapshot | AndroidBackPhaseEvent | {
+    kind: 'nativeUI.commandResult';
+    requestId: number;
+    presentationId: number;
+    value?: unknown;
+    error?: string;
+} | {
+    kind: 'systemBars.snapshot';
+    state: AndroidSystemBarsState;
+} | {
+    kind: 'toolbar.safeArea';
+    bottomInset: number;
+} | {
+    kind: 'keyboard.visibility';
+    visible: boolean;
+    focusedInput: FocusedInputLayout | null;
+    keepFocus: boolean;
+} | {
+    kind: 'keyboard.mode';
+    mode: KeyboardMode;
+} | {
+    kind: 'keyboard.hostDismiss';
+    keepFocus: boolean;
+} | {
+    kind: 'keyboard.layout';
+    layout: KeyboardLayoutSnapshot;
+} | {
+    kind: 'keyboard.animationFrame';
+    frame: KeyboardAnimationFrameSnapshot;
+} | {
+    kind: 'keyboard.popup';
+    popup: KeyboardPopupState | null;
+} | {
+    kind: 'keyboard.preloadComplete';
+    requestId: number;
+    runs: number;
+    cleanups: number;
+} | {
+    kind: 'overlay.pointerState';
+    regions: KeyRect[];
+} | {
+    kind: 'keyboard.keyPress';
+    key: string;
+} | {
+    kind: 'keyboard.acceptCandidate';
+    candidate: KeyboardCandidate;
+} | {
+    kind: 'webview.editorFocus';
+    instanceId: string;
+} | {
+    kind: 'keyboard.queryModeResult';
+    requestId: number;
+    mode: KeyboardMode;
+} | {
+    kind: 'keyboard.queryKeyRectResult';
+    requestId: number;
+    rect: KeyRect | null;
+} | {
+    kind: 'keyboard.queryPopupResult';
+    requestId: number;
+    popup: KeyboardPopupState | null;
+} | {
+    kind: 'alert.result';
+    requestId: number;
+    buttonIndex: number | null;
+    value?: AlertPromptValue;
+} | {
+    kind: 'actionSheet.result';
+    requestId: number;
+    buttonIndex: number | null;
+    timestamp?: number;
+} | {
+    kind: 'actionSheet.lifecycle';
+    requestId: number;
+    phase: 'presented' | 'dismissed';
+} | {
+    kind: 'authSession.cancel';
+    ownerId: string;
+    sessionId: number;
+} | {
+    kind: 'burnt.toastAction';
+    requestId: number;
+} | {
+    kind: 'burnt.toastDismissed';
+    requestId: number;
+    reason: 'timeout' | 'swipe';
+} | {
+    kind: 'androidPermission.result';
+    requestId: number;
+    results: Record<string, AndroidPermissionStatus>;
+} | {
+    kind: 'appIcon.result';
+    owner: import('../../../peach-globals/src/index.d.ts').ShellNativeEvaluationOwner;
+    evaluationId: string;
+    requestId: number;
+    name?: string;
+    error?: string;
+} | {
+    kind: 'systemPermission.result';
+    requestId: number;
+    result: SystemPermissionOperationResult;
+    owner?: import('../../../peach-globals/src/index.d.ts').ShellNativeEvaluationOwner;
+} | {
+    kind: 'systemPermission.changed';
+    snapshot: AppSettingsSnapshot;
+} | {
+    kind: 'appSettings.appsChanged';
+    apps: readonly SystemPermissionApp[];
+} | {
+    kind: 'appSettings.openRequested';
+    route: SootsimSettingsRoute;
+} | {
+    kind: 'safari.openRequested';
+    url: string;
+} | {
+    kind: 'appSettings.declaredSettingChanged';
+    appId: string;
+    key: string;
+    value: string;
+} | {
+    kind: 'imagePicker.result';
+    requestId: number;
+    result: ImagePickerResultSpec;
+    owner?: import('../../../peach-globals/src/index.d.ts').ShellNativeEvaluationOwner;
+} | {
+    kind: 'imageCropper.result';
+    requestId: number;
+    result: ImageCropperResultSpec;
+} | {
+    kind: 'androidDateTimePicker.result';
+    requestId: number;
+    result: AndroidDateTimePickerResultSpec;
+} | {
+    kind: 'shareSheet.result';
+    requestId: number;
+    result: ShareSheetResultSpec;
+} | {
+    kind: 'shareSheet.itemRequest';
+    requestId: number;
+    itemRequestId: number;
+} | {
+    kind: 'photoLibrary.queryResult';
+    requestId: number;
+    page: PhotoLibraryPageSpec;
+} | NativePhotoLibraryResult | NativePhotoLibraryChange | {
+    kind: 'photoLibrary.createAssetResult';
+    requestId: number;
+    result: {
+        asset: PhotoLibraryAssetSpec;
+    } | {
+        error: string;
+    };
+} | {
+    kind: 'viewShot.result';
+    requestId: number;
+    result: ViewShotCaptureResultSpec;
+} | {
+    kind: 'notification.tap';
+    id: string;
+    actionId?: string;
+    userText?: string;
+} | {
+    kind: 'notification.remote-push';
+    payload: Record<string, unknown>;
+    launch: boolean;
+    actionId?: string;
+    userText?: string;
+} | {
+    kind: 'webview.message';
+    instanceId: string;
+    data: string;
+    url: string;
+    loading: boolean;
+    title: string;
+    canGoBack: boolean;
+    canGoForward: boolean;
+    lockIdentifier: number;
+} | {
+    kind: 'webview.webKit';
+    instanceId: string;
+    payload: SootSimWebKitEvent;
+} | {
+    kind: 'webview.presentation';
+    instanceId: string;
+    live: boolean;
+    closable: boolean;
+} | {
+    kind: 'webview.loadStart';
+    instanceId: string;
+    url: string;
+    loading: boolean;
+    navigationType: SootSimWebViewNavigationType;
+} | {
+    kind: 'webview.load';
+    instanceId: string;
+    url: string;
+} | {
+    kind: 'webview.loadEnd';
+    instanceId: string;
+    url: string;
+} | {
+    kind: 'webview.openWindow';
+    instanceId: string;
+    targetUrl: string;
+} | {
+    kind: 'webview.navigationStateChange';
+    instanceId: string;
+    url: string;
+    title: string;
+    loading: boolean;
+    canGoBack: boolean;
+    canGoForward: boolean;
+} | {
+    kind: 'webview.shouldStartLoadWithRequest';
+    instanceId: string;
+    url: string;
+    mainDocumentURL: string;
+    navigationType: SootSimWebViewNavigationType;
+    isTopFrame: boolean;
+    hasTargetFrame: boolean;
+    lockIdentifier: number;
+    loading: boolean;
+} | {
+    kind: 'webview.loadingError';
+    instanceId: string;
+    url: string;
+    domain: string;
+    code: number;
+    description: string;
+    didFailProvisionalNavigation: boolean;
+} | {
+    kind: 'webview.httpError';
+    instanceId: string;
+    url: string;
+    statusCode: number;
+} | {
+    kind: 'devMenu.action';
+    action: 'reload' | 'toggleInspect' | 'openDebugger' | 'cycleA11y' | 'perfMonitor' | 'connectDisconnect';
+};
+export declare function isNativeUIRequest(value: unknown): value is NativeUIRequest;
+export declare function isNativeUIEvent(value: unknown): value is NativeUIEvent;
+export {};