@apps-in-toss/devtools 3.0.2

package/dist/mock/3x.d.ts

@@ -0,0 +1,1148 @@
+import * as SDK from "@apps-in-toss/web-framework";
+import { GraniteEvent, PermissionAccess, PermissionName as PermissionName$1, PermissionStatus as PermissionStatus$1, TdsEvent } from "@apps-in-toss/web-framework";
+//#region src/mock/domains-3x.d.ts
+declare const getIsTossLoginIntegratedService: (() => Promise<boolean | undefined>) & {
+  MIN_TOSS_APP_VERSION: {
+    readonly android: "5.237.0";
+    readonly ios: "5.237.0";
+  };
+  isSupported: () => boolean;
+};
+declare const getUserKeyForGame: (() => Promise<SDK.GetAnonymousKeyResponse | "ERROR" | undefined>) & {
+  MIN_TOSS_APP_VERSION: {
+    readonly android: "5.232.0";
+    readonly ios: "5.232.0";
+  };
+  isSupported: () => boolean;
+};
+declare const getAnonymousKey: (() => Promise<SDK.GetAnonymousKeyResponse | "ERROR" | undefined>) & {
+  MIN_TOSS_APP_VERSION: {
+    readonly android: "5.232.0";
+    readonly ios: "5.232.0";
+  };
+  isSupported: () => boolean;
+};
+declare const appsInTossSignTossCert: ((params: SDK.AppsInTossSignTossCertParams) => Promise<void>) & {
+  MIN_TOSS_APP_VERSION: {
+    readonly android: "5.233.0";
+    readonly ios: "5.233.0";
+  };
+  isSupported: () => boolean;
+};
+declare const getConsentedUserData: ((options: SDK.GetConsentedUserDataOptions) => Promise<SDK.ConsentedUserData | undefined>) & {
+  MIN_TOSS_APP_VERSION: {
+    readonly android: "5.264.0";
+    readonly ios: "5.264.0";
+  };
+  isSupported: () => boolean;
+};
+declare const getDeclaredAgeRange: ((params: SDK.GetDeclaredAgeRangeParams) => Promise<SDK.DeclaredAgeRange>) & {
+  MIN_TOSS_APP_VERSION: {
+    readonly ios: "5.266.0";
+  };
+  MIN_OS_VERSION: {
+    readonly ios: "26.0";
+  };
+  isSupported: () => boolean;
+};
+declare const setDeviceOrientation: ((options: SDK.SetDeviceOrientationOptions) => Promise<void>) & {
+  MIN_TOSS_APP_VERSION: {
+    readonly android: "5.215.0";
+    readonly ios: "5.215.0";
+  };
+  isSupported: () => boolean;
+};
+declare const getServerTime: (() => Promise<number | undefined>) & {
+  MIN_TOSS_APP_VERSION: {
+    readonly android: "5.245.0";
+    readonly ios: "5.245.0";
+  };
+  isSupported: () => boolean;
+};
+declare const requestReview: (() => Promise<void>) & {
+  MIN_TOSS_APP_VERSION: {
+    readonly android: "5.253.0";
+    readonly ios: "5.253.0";
+  };
+  isSupported: () => boolean;
+};
+declare const openPDFViewer: ((params: SDK.OpenPDFViewerParams) => Promise<"CLOSE">) & {
+  MIN_TOSS_APP_VERSION: {
+    readonly android: "5.261.0";
+    readonly ios: "5.261.0";
+  };
+  isSupported: () => boolean;
+};
+declare const saveBase64Data: ((params: SDK.SaveBase64DataParams) => Promise<void>) & {
+  MIN_TOSS_APP_VERSION: {
+    readonly android: "5.218.0";
+    readonly ios: "5.216.0";
+  };
+  isSupported: () => boolean;
+};
+declare const grantPromotionReward: ((params: SDK.GrantPromotionRewardParams) => Promise<"ERROR" | SDK.GrantPromotionRewardResponse | {
+  errorCode: string;
+  message: string;
+} | undefined>) & {
+  MIN_TOSS_APP_VERSION: {
+    readonly android: "5.232.0";
+    readonly ios: "5.232.0";
+  };
+  isSupported: () => boolean;
+};
+declare const grantPromotionRewardForGame: ((params: SDK.GrantPromotionRewardParams) => Promise<"ERROR" | SDK.GrantPromotionRewardResponse | {
+  errorCode: string;
+  message: string;
+} | undefined>) & {
+  MIN_TOSS_APP_VERSION: {
+    readonly android: "5.232.0";
+    readonly ios: "5.232.0";
+  };
+  isSupported: () => boolean;
+};
+declare const submitGameCenterLeaderBoardScore: ((params: {
+  score: string;
+}) => Promise<SDK.SubmitGameCenterLeaderBoardScoreResponse | undefined>) & {
+  MIN_TOSS_APP_VERSION: {
+    readonly android: "5.221.0";
+    readonly ios: "5.221.0";
+  };
+  isSupported: () => boolean;
+};
+declare const getGameCenterGameProfile: (() => Promise<SDK.GameCenterGameProfileResponse | undefined>) & {
+  MIN_TOSS_APP_VERSION: {
+    readonly android: "5.221.0";
+    readonly ios: "5.221.0";
+  };
+  isSupported: () => boolean;
+};
+declare const openGameCenterLeaderboard: (() => Promise<void>) & {
+  MIN_TOSS_APP_VERSION: {
+    readonly android: "5.221.0";
+    readonly ios: "5.221.0";
+  };
+  isSupported: () => boolean;
+};
+declare const contactsViral: ((params: SDK.ContactsViralParams) => (() => void)) & {
+  MIN_TOSS_APP_VERSION: {
+    readonly android: "5.223.0";
+    readonly ios: "5.223.0";
+  };
+  isSupported: () => boolean;
+};
+declare const requestNotificationAgreement: ((params: SDK.RequestNotificationAgreementOptions) => () => void) & {
+  MIN_TOSS_APP_VERSION: {
+    readonly android: "5.255.0";
+    readonly ios: "5.255.0";
+  };
+  isSupported: () => boolean;
+};
+declare const requestTossPayPaysBilling: ((options: {
+  params: SDK.RequestTossPayPaysBillingOptions;
+}) => Promise<SDK.RequestTossPayPaysBillingResult | undefined>) & {
+  MIN_TOSS_APP_VERSION: {
+    readonly android: "5.256.0";
+    readonly ios: "5.256.0";
+  };
+  isSupported: () => boolean;
+};
+declare const getPlatformOS: typeof SDK.getPlatformOS;
+declare const getOperationalEnvironment: typeof SDK.getOperationalEnvironment;
+declare const getLocale: typeof SDK.getLocale;
+declare const getDeviceId: typeof SDK.getDeviceId;
+declare const getSchemeUri: typeof SDK.getSchemeUri;
+declare const getSafeAreaInsets: typeof SDK.getSafeAreaInsets;
+declare const isMinVersionSupported: typeof SDK.isMinVersionSupported;
+declare const GoogleAdMob: typeof SDK.GoogleAdMob;
+declare const loadFullScreenAd: typeof SDK.loadFullScreenAd;
+declare const showFullScreenAd: typeof SDK.showFullScreenAd;
+declare const IAP: typeof SDK.IAP;
+declare const Analytics: typeof SDK.Analytics;
+declare const Clipboard: typeof SDK.Clipboard;
+declare const Device: typeof SDK.Device;
+declare const Environment: typeof SDK.Environment;
+declare const File: typeof SDK.File;
+declare const Game: typeof SDK.Game;
+declare const Notification: typeof SDK.Notification;
+declare const Promotion: typeof SDK.Promotion;
+declare const Review: typeof SDK.Review;
+declare const SafeArea: typeof SDK.SafeArea;
+declare const Screen: typeof SDK.Screen;
+declare const Share: typeof SDK.Share;
+declare const TossAuth: typeof SDK.TossAuth;
+declare const TossPay: typeof SDK.TossPay;
+declare const User: typeof SDK.User;
+//#endregion
+//#region src/mock/ads/index.d.ts
+declare const TossAds: {
+  initialize: ((options: {
+    callbacks?: {
+      onInitialized?: () => void;
+      onInitializationFailed?: (error: Error) => void;
+    };
+  }) => void) & {
+    isSupported: () => boolean;
+  };
+  attach: ((_adGroupId: string, target: string | HTMLElement, _options?: unknown) => void) & {
+    isSupported: () => boolean;
+  };
+  attachBanner: ((adGroupId: string, target: string | HTMLElement, options?: {
+    theme?: "auto" | "light" | "dark";
+    tone?: "blackAndWhite" | "grey";
+    variant?: "card" | "expanded";
+    callbacks?: {
+      onAdRendered?: (payload: {
+        slotId: string;
+        adGroupId: string;
+        adMetadata: {
+          creativeId: string;
+          requestId: string;
+        };
+      }) => void;
+      onAdViewable?: (payload: {
+        slotId: string;
+        adGroupId: string;
+        adMetadata: {
+          creativeId: string;
+          requestId: string;
+        };
+      }) => void;
+      onAdClicked?: (payload: {
+        slotId: string;
+        adGroupId: string;
+        adMetadata: {
+          creativeId: string;
+          requestId: string;
+        };
+      }) => void;
+      onAdImpression?: (payload: {
+        slotId: string;
+        adGroupId: string;
+        adMetadata: {
+          creativeId: string;
+          requestId: string;
+        };
+      }) => void;
+      onAdFailedToRender?: (payload: {
+        slotId: string;
+        adGroupId: string;
+        adMetadata: Record<string, never>;
+        error: {
+          code: number;
+          message: string;
+          domain?: string;
+        };
+      }) => void;
+      onNoFill?: (payload: {
+        slotId: string;
+        adGroupId: string;
+        adMetadata: Record<string, never>;
+      }) => void;
+    };
+  } | undefined) => {
+    destroy: () => void;
+  }) & {
+    isSupported: () => boolean;
+  };
+  destroy: ((slotId: string) => void) & {
+    isSupported: () => boolean;
+  };
+  destroyAll: (() => void) & {
+    isSupported: () => boolean;
+  };
+};
+//#endregion
+//#region src/mock/analytics/index.d.ts
+/**
+ * Analytics mock
+ */
+type Primitive$1 = string | number | boolean | null | undefined | symbol;
+declare function eventLog(params: {
+  log_name: string;
+  log_type: string;
+  params: Record<string, Primitive$1>;
+}): Promise<void>;
+//#endregion
+//#region src/mock/types.d.ts
+type Primitive = string | number | boolean | null | undefined | symbol;
+type PlatformOS = "ios" | "android";
+type OperationalEnvironment = "toss" | "sandbox";
+type NetworkStatus = "OFFLINE" | "WIFI" | "2G" | "3G" | "4G" | "5G" | "WWAN" | "UNKNOWN";
+type PermissionStatus = "notDetermined" | "denied" | "allowed";
+type PermissionName = "clipboard" | "contacts" | "photos" | "geolocation" | "camera" | "microphone";
+type HapticFeedbackType = "tickWeak" | "tap" | "tickMedium" | "softMedium" | "basicWeak" | "basicMedium" | "success" | "error" | "wiggle" | "confetti";
+type DeviceApiMode = "mock" | "web" | "prompt";
+interface DeviceModes {
+  camera: DeviceApiMode;
+  photos: DeviceApiMode;
+  location: DeviceApiMode;
+  network: "mock" | "web";
+  clipboard: "mock" | "web";
+}
+interface MockData {
+  images: string[];
+  clipboardText: string;
+}
+interface LocationCoords {
+  latitude: number;
+  longitude: number;
+  altitude: number;
+  accuracy: number;
+  altitudeAccuracy: number;
+  heading: number;
+}
+interface MockLocation {
+  coords: LocationCoords;
+  timestamp: number;
+  accessLocation?: "FINE" | "COARSE";
+}
+interface MockContact {
+  name: string;
+  phoneNumber: string;
+}
+interface MockIapProduct {
+  sku: string;
+  type: "CONSUMABLE" | "NON_CONSUMABLE" | "SUBSCRIPTION";
+  displayName: string;
+  displayAmount: string;
+  iconUrl: string;
+  description: string;
+  renewalCycle?: "WEEKLY" | "MONTHLY" | "YEARLY";
+}
+type IapNextResult = "success" | "USER_CANCELED" | "INVALID_PRODUCT_ID" | "PAYMENT_PENDING" | "NETWORK_ERROR" | "ITEM_ALREADY_OWNED" | "INTERNAL_ERROR";
+type NotificationAgreementResult = "newAgreement" | "alreadyAgreed" | "agreementRejected";
+/**
+ * `getConsentedUserData`가 반환할 수 있는 동의 데이터 키. SDK 선언(`@apps-in-toss/web-bridge`
+ * 경유, web-framework 2.x 라인)의 `ConsentedUserDataKey`와 이름·값 동일(devtools#798).
+ */
+type ConsentedUserDataKey = "USER_NAME" | "USER_GENDER" | "USER_NATIONALITY" | "USER_BIRTHDAY" | "USER_PHONE" | "USER_ADDRESS" | "USER_EMAIL" | "USER_CONSUMPTION_HISTORY";
+/** `getConsentedUserData`의 반환 shape. SDK 선언과 동일한 `Partial<Record<..., string>>`. */
+type ConsentedUserData = Partial<Record<ConsentedUserDataKey, string>>;
+interface DeclaredAgeRange {
+  status: "SHARING" | "DECLINED_SHARING" | "UNSUPPORTED_OS" | "NOT_AVAILABLE" | "INVALID_REQUEST" | "FAILED";
+  lowerBound?: number;
+  upperBound?: number;
+  ageRangeDeclaration?: string;
+  activeParentalControls: string[];
+  isEligibleForAgeFeatures?: boolean;
+  errorCode?: string;
+}
+interface AnalyticsLogEntry {
+  timestamp: number;
+  type: string;
+  params: Record<string, unknown>;
+}
+interface SafeAreaInsets$1 {
+  top: number;
+  bottom: number;
+  left: number;
+  right: number;
+}
+type ViewportPresetId = "none" | "iphone-se-3" | "iphone-15-pro" | "iphone-16e" | "iphone-17" | "iphone-air" | "iphone-17-pro" | "iphone-17-pro-max" | "galaxy-s26" | "galaxy-s26-plus" | "galaxy-s26-ultra" | "galaxy-z-flip7" | "galaxy-z-fold7-folded" | "galaxy-z-fold7-unfolded" | "custom";
+/**
+ * Panel의 orientation 선택.
+ * - `auto` — Panel이 강제하지 않음. 앱의 SDK `setDeviceOrientation` 호출을 그대로 따름.
+ *   호출 값은 별도로 `viewport.appOrientation`에 기록되며, `viewport.orientation`은
+ *   계속 `auto`로 유지된다 — 같은 앱이 여러 번 호출해도 매번 정상 반영됨.
+ * - `portrait` / `landscape` — Panel이 강제. SDK 호출은 무시됨 (로그만 남김).
+ */
+type ViewportOrientation = "auto" | "portrait" | "landscape";
+/**
+ * `setDeviceOrientation`이 한 번도 호출되지 않은 초기 상태는 `null`.
+ * SDK가 받을 수 있는 값과 일치하므로 portrait/landscape만 허용.
+ */
+type AppOrientation = "portrait" | "landscape" | null;
+/**
+ * Apps in Toss host nav bar 변형. SDK `webViewProps.type`과 의미 일치.
+ * - `partner` (기본): 흰 배경, 뒤로가기 + 앱 아이콘/이름 + ⋯ + ×.
+ * - `game`: 투명 배경, 게임 캔버스를 가리지 않도록 ⋯ + ×만 표시.
+ */
+type AitNavBarType = "partner" | "game";
+interface ViewportState {
+  preset: ViewportPresetId;
+  /** User-controlled orientation. `auto`이면 `appOrientation`을 따른다. */
+  orientation: ViewportOrientation;
+  /**
+   * SDK가 마지막으로 요청한 orientation. `setDeviceOrientation` 호출 시 갱신.
+   * `orientation === 'auto'`일 때 실제 화면 방향 결정에 쓰인다. 초기값 `null`.
+   */
+  appOrientation: AppOrientation;
+  customWidth: number;
+  customHeight: number;
+  frame: boolean;
+  /** Render the Apps in Toss host nav bar (back / app name / ··· / close) inside the frame. */
+  aitNavBar: boolean;
+  /** Nav bar 변형. `partner` = 기본(흰 배경 + 아이콘/이름), `game` = 투명 배경 + ⋯/× 만. */
+  aitNavBarType: AitNavBarType;
+}
+//#endregion
+//#region src/mock/auth/index.d.ts
+declare function appLogin(): Promise<{
+  authorizationCode: string;
+  referrer: "DEFAULT" | "SANDBOX";
+}>;
+//#endregion
+//#region src/mock/bridge-factories.d.ts
+/** Generic bridge escape hatches exposed by both SDK lines. */
+declare function createAsyncBridge<Args extends unknown[] = unknown[], Result = unknown>(method: string): (...args: Args) => Promise<Result>;
+declare function createConstantBridge<T>(name: string): () => T;
+declare function createEventBridge<Options = unknown, Event = unknown>(method: string): (args: {
+  options?: Options;
+  onEvent: (event: Event) => void;
+  onError: (error: Error) => void;
+}) => () => void;
+//#endregion
+//#region src/mock/device/_helpers.d.ts
+/**
+ * 디바이스 모듈 내부 공유 헬퍼
+ */
+declare function getDefaultPlaceholderImages(): string[];
+//#endregion
+//#region src/mock/device/camera.d.ts
+/**
+ * Camera & Album Photos & Album Items mock
+ * mock/web/prompt 모드 지원
+ */
+type AlbumItemType = "PHOTO" | "VIDEO";
+declare const openCamera: ((_options?: {
+  base64?: boolean;
+  maxWidth?: number;
+}) => Promise<{
+  id: string;
+  dataUri: string;
+}>) & {
+  getPermission: () => Promise<import("@apps-in-toss/web-framework").PermissionStatus>;
+  openPermissionDialog: () => Promise<"allowed" | "denied">;
+};
+declare const fetchAlbumPhotos: ((options?: {
+  maxCount?: number;
+  maxWidth?: number;
+  base64?: boolean;
+}) => Promise<Array<{
+  id: string;
+  dataUri: string;
+}>>) & {
+  getPermission: () => Promise<import("@apps-in-toss/web-framework").PermissionStatus>;
+  openPermissionDialog: () => Promise<"allowed" | "denied">;
+};
+interface FetchAlbumItemsOptions {
+  types?: AlbumItemType[];
+  maxCount?: number;
+  maxWidth?: number;
+  base64?: boolean;
+}
+interface AlbumItemResponse {
+  id: string;
+  dataUri: string;
+  type: AlbumItemType;
+}
+declare const _fetchAlbumItemsWithPermission: ((options?: FetchAlbumItemsOptions) => Promise<AlbumItemResponse[]>) & {
+  getPermission: () => Promise<import("@apps-in-toss/web-framework").PermissionStatus>;
+  openPermissionDialog: () => Promise<"allowed" | "denied">;
+};
+declare const fetchAlbumItems: typeof _fetchAlbumItemsWithPermission & {
+  isSupported: () => boolean;
+};
+//#endregion
+//#region src/mock/device/clipboard.d.ts
+/**
+ * Clipboard mock
+ * mock/web 모드 지원
+ */
+declare const getClipboardText: (() => Promise<string>) & {
+  getPermission: () => Promise<import("@apps-in-toss/web-framework").PermissionStatus>;
+  openPermissionDialog: () => Promise<"allowed" | "denied">;
+};
+declare const setClipboardText: ((text: string) => Promise<void>) & {
+  getPermission: () => Promise<import("@apps-in-toss/web-framework").PermissionStatus>;
+  openPermissionDialog: () => Promise<"allowed" | "denied">;
+};
+//#endregion
+//#region src/mock/device/contacts.d.ts
+declare const _fetchContacts: (options: {
+  size: number;
+  offset: number;
+  query?: {
+    contains?: string;
+  };
+}) => Promise<{
+  result: MockContact[];
+  nextOffset: number | null;
+  done: boolean;
+}>;
+/**
+ * 상류 SDK는 `fetchContacts`의 타입에 `.getPermission`/`.openPermissionDialog`를
+ * `PermissionFunctionWithDialog`로 선언하지만, 실기기(2.x×iOS)에는 그 메서드가
+ * **런타임에 붙어 있지 않다**(devtools#795 — 호출 시 `fetchContacts.getPermission
+ * is not a function` native `TypeError`). standalone `getPermission({name:
+ * 'contacts', access: 'access'})`는 실기기에서 정상 resolve하므로(env3 run11,
+ * `../permissions.ts`) 부재는 fetchContacts에 **부착된** 메서드에만 해당하는
+ * 상류 타입↔런타임 불일치다.
+ *
+ * mock은 다른 device API처럼 `withPermission()`으로 감싸지 않고, bare async fn을
+ * 상류 시그니처로만 캐스트한다 — `.getPermission`/`.openPermissionDialog` 접근은
+ * `undefined`가 되고, 호출하면 `undefined()` → native `TypeError`로 떨어져
+ * 실기기와 일치한다(`__typecheck.ts`/`__typecheck-2x.ts`는 캐스트 타입에 두
+ * 메서드가 여전히 남아 있어 그대로 통과). `_fetchContacts` 내부에서 이미
+ * `checkPermission`을 호출하므로 메인 동작(권한 거부 시
+ * `FetchContactsPermissionError`)은 변화 없다.
+ *
+ * 직접 관측된 것은 `getPermission` 부재뿐이다. `openPermissionDialog` 부재는
+ * "상류가 fetchContacts에 권한 헬퍼 전체를 붙이지 않는다"는 합리적 추론이지
+ * 별도 실측은 아니다. 다른 `withPermission` API(clipboard/camera/location)로는
+ * 이 부재를 확장하지 않는다 — 그쪽 부착 메서드가 실기기에서 없다는 관측은
+ * 없다(#783 "측정 밖 확장 금지" 원칙).
+ */
+declare const fetchContacts: typeof _fetchContacts & {
+  getPermission: () => Promise<PermissionStatus$1>;
+  openPermissionDialog: () => Promise<"allowed" | "denied">;
+};
+//#endregion
+//#region src/mock/device/haptic.d.ts
+declare function generateHapticFeedback(options: {
+  type: HapticFeedbackType;
+}): Promise<void>;
+//#endregion
+//#region src/mock/device/location.d.ts
+declare enum Accuracy {
+  Lowest = 1,
+  Low = 2,
+  Balanced = 3,
+  High = 4,
+  Highest = 5,
+  BestForNavigation = 6
+}
+declare const getCurrentLocation: ((_options?: {
+  accuracy: Accuracy;
+}) => Promise<MockLocation>) & {
+  getPermission: () => Promise<import("@apps-in-toss/web-framework").PermissionStatus>;
+  openPermissionDialog: () => Promise<"allowed" | "denied">;
+};
+interface StartUpdateLocationEventParams {
+  onEvent: (response: MockLocation) => void;
+  onError: (error: unknown) => void;
+  options: {
+    accuracy: Accuracy;
+    timeInterval: number;
+    distanceInterval: number;
+  };
+}
+declare const startUpdateLocation: ((eventParams: StartUpdateLocationEventParams) => (() => void)) & {
+  getPermission: () => Promise<import("@apps-in-toss/web-framework").PermissionStatus>;
+  openPermissionDialog: () => Promise<"allowed" | "denied">;
+};
+//#endregion
+//#region src/mock/device/storage.d.ts
+/**
+ * Storage mock
+ * localStorage에 `__ait_storage:` prefix로 저장하여 앱 자체 localStorage와 분리
+ *
+ * 실기기(2.x×iOS) capture는 `setItem`/`removeItem`/`clearItems` 세 메서드가
+ * `undefined`가 아니라 `null`로 resolve됨을 보였다(devtools#770). 원본 SDK 타입
+ * 선언은 여전히 `Promise<void>`이므로 시그니처는 그대로 두고, 런타임 반환값만
+ * `null`로 캐스트해 실측과 동치시킨다 — Analytics·setClipboardText와 같은 처리(#775).
+ * `getItem`은 이미 `string | null`이라 실측과 일치하므로 손대지 않는다.
+ */
+declare const Storage: {
+  getItem: (key: string) => Promise<string | null>;
+  setItem: (key: string, value: string) => Promise<void>;
+  removeItem: (key: string) => Promise<void>;
+  clearItems: () => Promise<void>;
+};
+//#endregion
+//#region src/mock/iap/index.d.ts
+declare function checkoutPayment(options: {
+  params: {
+    payToken: string;
+  };
+}): Promise<{
+  success: boolean;
+  reason?: string;
+}>;
+//#endregion
+//#region src/mock/navigation/index.d.ts
+declare function closeView(): Promise<void>;
+declare function openURL(url: string): Promise<void>;
+declare function share(message: {
+  message: string;
+}): Promise<void>;
+declare function getTossShareLink(path: string, _ogImageUrl?: string): Promise<string>;
+declare function setIosSwipeGestureEnabled(options: {
+  isEnabled: boolean;
+}): Promise<void>;
+declare const setScreenAwakeMode: (options: {
+  enabled: boolean;
+}) => Promise<{
+  enabled: boolean;
+}>;
+declare const setSecureScreen: (options: {
+  enabled: boolean;
+}) => Promise<{
+  enabled: boolean;
+}>;
+declare function getTossAppVersion(): string;
+declare function getGroupId(): string;
+declare function getNetworkStatus(): Promise<NetworkStatus>;
+declare const graniteEvent: {
+  addEventListener<K extends keyof GraniteEvent>(event: K, { onEvent, onError }: {
+    onEvent: GraniteEvent[K]["onEvent"];
+    onError?: GraniteEvent[K]["onError"];
+    options?: GraniteEvent[K]["options"];
+  }): () => void;
+};
+declare const appsInTossEvent: {
+  addEventListener<K extends string>(_event: K, _handlers: {
+    onEvent: (...args: unknown[]) => void;
+    onError?: (error: Error) => void;
+    options?: unknown;
+  }): () => void;
+};
+declare const tdsEvent: {
+  addEventListener<K extends keyof TdsEvent>(event: K, { onEvent }: {
+    onEvent: TdsEvent[K]["onEvent"];
+    onError?: TdsEvent[K]["onError"];
+    options?: TdsEvent[K]["options"];
+  }): () => void;
+};
+/**
+ * @deprecated web-framework 3.0 에서 제거됨. 2.x 소비자 back-compat용으로 유지.
+ */
+declare function onVisibilityChangedByTransparentServiceWeb(eventParams: {
+  options: {
+    callbackId: string;
+  };
+  onEvent: (isVisible: boolean) => void;
+  onError: (error: unknown) => void;
+}): () => void;
+declare const env: {
+  getDeploymentId: () => string;
+};
+declare function getAppsInTossGlobals(): {
+  deploymentId: string;
+  brandDisplayName: string;
+  brandIcon: string;
+  brandPrimaryColor: string;
+};
+type SafeAreaInsetsValue = {
+  top: number;
+  bottom: number;
+  left: number;
+  right: number;
+};
+type SafeAreaInsetsSubscribeHandler = {
+  onEvent: (data: SafeAreaInsetsValue) => void;
+};
+declare const SafeAreaInsets: {
+  get: () => SafeAreaInsetsValue;
+  subscribe: ({ onEvent }: SafeAreaInsetsSubscribeHandler) => (() => void);
+};
+//#endregion
+//#region src/mock/partner/index.d.ts
+/**
+ * Partner / TDS mock
+ */
+interface AddAccessoryButtonOptions {
+  id: string;
+  title: string;
+  icon: {
+    name: string;
+  };
+}
+declare const partner: {
+  addAccessoryButton(options: AddAccessoryButtonOptions): Promise<void>;
+  removeAccessoryButton(): Promise<void>;
+};
+//#endregion
+//#region src/mock/permissions.d.ts
+/**
+ * web-framework 3.0+ 권한 에러 기반 클래스.
+ * `instanceof PermissionError`로 체크하는 코드와 호환된다.
+ */
+declare class PermissionError extends Error {
+  constructor({ methodName, message }: {
+    methodName: string;
+    message?: string;
+  });
+}
+/** openCamera 권한 에러 */
+declare class OpenCameraPermissionError extends PermissionError {
+  constructor();
+}
+/** fetchAlbumPhotos 권한 에러 */
+declare class FetchAlbumPhotosPermissionError extends PermissionError {
+  constructor();
+}
+/** fetchContacts 권한 에러 */
+declare class FetchContactsPermissionError extends PermissionError {
+  constructor();
+}
+/** getCurrentLocation 권한 에러 */
+declare class GetCurrentLocationPermissionError extends PermissionError {
+  constructor();
+}
+/** getClipboardText 권한 에러 */
+declare class GetClipboardTextPermissionError extends PermissionError {
+  constructor();
+}
+/** setClipboardText 권한 에러 */
+declare class SetClipboardTextPermissionError extends PermissionError {
+  constructor();
+}
+/**
+ * startUpdateLocation 권한 에러.
+ * web-framework 3.0에서 GetCurrentLocationPermissionError의 alias.
+ */
+declare const StartUpdateLocationPermissionError: typeof GetCurrentLocationPermissionError;
+declare function getPermission(permission: {
+  name: PermissionName$1;
+  access: PermissionAccess;
+}): Promise<PermissionStatus$1>;
+declare function openPermissionDialog(permission: {
+  name: PermissionName$1;
+  access: PermissionAccess;
+}): Promise<"allowed" | "denied">;
+declare function requestPermission(permission: {
+  name: PermissionName$1;
+  access: PermissionAccess;
+}): Promise<"allowed" | "denied">;
+//#endregion
+//#region src/mock/native-error.d.ts
+/**
+ * sdk-example#284 매트릭스에 등재된 2.x 네이티브 실패 코드 인벤토리.
+ * 새 코드가 매트릭스에 추가되면 여기에도 추가한다.
+ */
+type NativeErrorCode = "APP_LOGIN" | "PLACEMENT_ID_FETCH_FAILED" | "EXECUTION_ERROR" | "NO_PERMISSION" | "INVALID_REQUEST" | "INVALID_DATA" | "FAILED_TO_GET_LOADED_AD" | "APP_BRIDGE_THROTTLED" | "1006" | "4000";
+//#endregion
+//#region src/mock/sdk-call.d.ts
+/**
+ * SDK-call trace shape produced by the mock's `observe()` wrapper.
+ *
+ * These declarations used to live in `src/mcp/ait-source.ts` (that module is now
+ * `@ait-co/debugger`'s `packages/debugger/src/mcp/ait-source.ts`) because the MCP
+ * `AIT.getSdkCallHistory` tool was their only *consumer*. After the debug
+ * surface moved to `@ait-co/debugger` (#818) the producer — `observe()`
+ * writing into `aitState.sdkCallLog` — is the only side left in this package,
+ * so the types live next to it.
+ *
+ * They stay part of the public `@apps-in-toss/devtools/mock` surface (re-exported by
+ * `state.ts`): a consumer reading `window.__ait.sdkCallLog` needs the shape,
+ * and any out-of-process reader (the MCP daemon among them) types against the
+ * same declarations.
+ */
+/**
+ * Mock fidelity grade of the SDK call.
+ * - `faithful` — mock faithfully reproduces the real SDK contract (🟢).
+ * - `partial`  — mock partially matches; edge cases may differ from real (🟡).
+ * - `inert`    — mock accepts the call but produces no observable effect (🔴).
+ */
+type AitSdkCallFidelity = "faithful" | "partial" | "inert";
+/** One entry of the SDK-call trace. */
+interface AitSdkCall {
+  /** SDK method name, e.g. `getOperationalEnvironment`, `saveBase64Data`. */
+  method: string;
+  /** Arguments passed to the call, serialized for transport. */
+  args: unknown[];
+  /** Milliseconds since epoch when the call was made. */
+  timestamp: number;
+  /** Outcome — resolved value, rejection error message, or still pending. */
+  status: "resolved" | "rejected" | "pending";
+  /** Serialized resolved value when `status === 'resolved'`. */
+  result?: unknown;
+  /** Error message when `status === 'rejected'`. */
+  error?: string;
+  /** Mock fidelity grade — how closely this mock reproduces the real SDK behaviour. */
+  fidelity: AitSdkCallFidelity;
+}
+//#endregion
+//#region src/mock/state.d.ts
+type Listener = () => void;
+interface AitDevtoolsState {
+  platform: PlatformOS;
+  environment: OperationalEnvironment;
+  appVersion: string;
+  locale: string;
+  schemeUri: string;
+  groupId: string;
+  deploymentId: string;
+  deviceId: string;
+  brand: {
+    displayName: string;
+    icon: string;
+    primaryColor: string;
+  };
+  networkStatus: NetworkStatus;
+  navigation: {
+    iosSwipeGestureEnabled: boolean | null;
+  };
+  permissions: Record<PermissionName, PermissionStatus>;
+  location: MockLocation;
+  safeAreaInsets: SafeAreaInsets$1;
+  contacts: MockContact[];
+  iap: {
+    products: MockIapProduct[];
+    nextResult: IapNextResult;
+    pendingOrders: Array<{
+      orderId: string;
+      sku: string;
+      paymentCompletedDate: string;
+    }>;
+    completedOrders: Array<{
+      orderId: string;
+      sku: string;
+      status: "COMPLETED" | "REFUNDED";
+      date: string;
+    }>;
+  };
+  payment: {
+    nextResult: "success" | "fail";
+    failReason: string;
+  };
+  auth: {
+    isLoggedIn: boolean;
+    isTossLoginIntegrated: boolean;
+    userKeyHash: string;
+    anonymousKeyHash: string;
+    /**
+     * `getConsentedUserData`가 resolve할 최소 plausible 객체(devtools#798). 실제로는
+     * 콘솔에 등록된 동의문/데이터 묶음(`consentedUserDataKey`)에 따라 채워지는 키가
+     * 달라지지만 그 매핑은 서버 쪽 설정이라 mock이 알 수 없다 — 호출 파라미터와
+     * 무관하게 이 상태값을 그대로 반환한다.
+     */
+    consentedUserData: ConsentedUserData;
+    /** `getDeclaredAgeRange`/`User.getDeclaredAgeRange`가 반환할 테스트 값. */
+    declaredAgeRange: DeclaredAgeRange;
+  };
+  notification: {
+    nextResult: NotificationAgreementResult;
+  };
+  ads: {
+    isLoaded: boolean;
+    nextEvent: "loaded" | "clicked" | "dismissed" | "failedToShow" | "impression" | "userEarnedReward";
+    forceNoFill: boolean;
+    lastEvent: {
+      type: string;
+      timestamp: number;
+    } | null;
+    /** AdMob reward 단위 타입 (기본: 'coins') */
+    rewardUnitType: string;
+    /** AdMob reward 단위 수량 (기본: 10) */
+    rewardAmount: number;
+  };
+  game: {
+    profile: {
+      nickname: string;
+      profileImageUri: string;
+    } | null;
+    leaderboardScores: Array<{
+      score: string;
+      timestamp: number;
+    }>;
+  };
+  analyticsLog: AnalyticsLogEntry[];
+  sdkCallLog: AitSdkCall[];
+  deviceModes: DeviceModes;
+  mockData: MockData;
+  panelEditable: boolean;
+  viewport: ViewportState;
+  failureModes: FailureModes;
+}
+/**
+ * per-API 실패 코드 다이얼. 값이 설정된 API만 mock이 reject하고, 나머지는
+ * 기존 낙관적 resolve를 유지한다. `sdkLine`은 envelope shape 분기 축 —
+ * `'2.x'`(기본)는 native envelope(`{name,code,userInfo,moduleName,__isError}`),
+ * `'3.x'`는 맨 Error로 평탄화(sdk-example#284 매트릭스 "패턴 ① envelope 평탄화").
+ */
+interface FailureModes {
+  /** 네이티브 실패 envelope의 라인 축. 기본 '2.x'. */
+  sdkLine: "2.x" | "3.x";
+  /** appLogin 실패 코드 (예: 'APP_LOGIN'). 미설정 시 기존처럼 항상 resolve. */
+  appLogin?: NativeErrorCode;
+  /** GoogleAdMob.loadAppsInTossAdMob 실패 코드 (예: 'PLACEMENT_ID_FETCH_FAILED'). */
+  loadAdMob?: NativeErrorCode;
+  /** loadFullScreenAd 실패 코드 (예: 'EXECUTION_ERROR'). */
+  loadFullScreenAd?: NativeErrorCode;
+  /**
+   * getIsTossLoginIntegratedService 실패 코드 (devtools#783 실측: env3 run11,
+   * 2.x/iOS `A1-awaited-is-boolean` 시나리오 — rejected/`Error`/`EXECUTION_ERROR`).
+   */
+  getIsTossLoginIntegratedService?: NativeErrorCode;
+  /**
+   * requestNotificationAgreement 실패 코드 (devtools#783 실측: env3 run11,
+   * 2.x/iOS `happy-force-*`/`A1-empty-templateCode` 시나리오 전부 —
+   * rejected/`Error`/`4000`).
+   */
+  requestNotificationAgreement?: NativeErrorCode;
+  /**
+   * 권한 이름별 실패 코드 (devtools#783 실측: env3 run11, 2.x/iOS
+   * `permissions.ait.test.ts` PERMISSION_NAMES 순회 — `geolocation`/`camera`/
+   * `microphone`만 rejected/`Error`/`NO_PERMISSION`, `clipboard`/`contacts`/
+   * `photos`는 resolved. 31146의 `granite.config.ts`가 `permissions: []`라
+   * 선언 안 된 권한만 거부되는 그림과 정합 — 전역 on/off가 아니라 이름 단위 맵.
+   * 설정된 이름만 reject, 나머지는 기존대로 resolve.
+   */
+  getPermission?: Partial<Record<PermissionName, NativeErrorCode>>;
+  /**
+   * THROTTLED 다이얼 (#834) — 실기기 네이티브 브리지의 per-method rate limit을
+   * 재현한다. `methods`에 적힌 메서드를 `intervalMs` 안에 재호출하면
+   * `APP_BRIDGE_THROTTLED`로 거부된다(2.x envelope / 3.x 맨 Error는 `sdkLine`을 따름).
+   * 미설정이 기본 = zero behavior change.
+   *
+   * 훅이 실제로 삽입된 메서드는 `throttle.ts`의 `THROTTLE_INSTRUMENTED_METHODS`가
+   * 정본이다 — 목록 밖 이름을 넣어도 효과가 없다. 거부된 호출은 창을 갱신하지 않는다.
+   */
+  throttled?: {
+    methods: string[];
+    intervalMs: number;
+  };
+  /**
+   * soft-resolve 다이얼 (#789) — reject가 아니라 "다른 shape로 resolve"하는 env3
+   * 프로비저닝-의존 실패를 재현한다. 켠 API만 실측 대체 shape로 resolve하고, 미설정
+   * API는 선언 타입대로 성공 shape를 유지한다(다이얼 미사용 시 zero behavior change).
+   * shape는 API별 고정(env3 run11 2.x/iOS 실측 — valueKeys만 실측, 문자열 내용은 예시):
+   *   grantPromotionReward/grantPromotionRewardForGame → { errorCode, message }
+   *   getSubscriptionInfo → {}
+   *   checkoutPayment/requestTossPayPaysBilling → { false, reason } (valueKeys=['false','reason'])
+   * payment shape의 리터럴 `false` 키가 하네스 artifact가 아니라 실기기 WebView 관측값임은
+   * 코드로 확정됐다(sdk-example#303: capture는 relay 개입 전 WebView 안에서 계산 — 아래
+   * checkoutPayment 항목 주석). #303/#789.
+   */
+  softResolve?: {
+    grantPromotionReward?: boolean;
+    grantPromotionRewardForGame?: boolean;
+    getSubscriptionInfo?: boolean;
+    /**
+     * checkoutPayment/requestTossPayPaysBilling → `{ false: …, reason: … }`
+     * (valueKeys=['false','reason'], booleanValues=null). env3 run11 실측 shape로,
+     * 리터럴 `false` 키는 실기기 WebView가 실제로 관측한 형태다 — capture는 WebView
+     * 안에서 `Object.keys(value)`로 계산돼 console 문자열로 나오므로(devtools#696
+     * capture.ts) 우리 CDP relay가 개입하기 전이다. 즉 relay 역직렬화 artifact가 아니라
+     * 모든 WebView 소비자가 보는 shape다(sdk-example#303 진단 결론). 성공 분기 기본값
+     * ({ success: true })은 그대로 두고, 미프로비저닝 실패 재현만 다이얼에 붙인다.
+     */
+    checkoutPayment?: boolean;
+    requestTossPayPaysBilling?: boolean;
+  };
+}
+declare class AitStateManager {
+  private _state;
+  private _listeners;
+  private _inTransaction;
+  constructor();
+  get state(): AitDevtoolsState;
+  update(partial: Partial<AitDevtoolsState>): void;
+  /** 중첩 객체 업데이트용 */
+  patch<K extends keyof AitDevtoolsState>(key: K, partial: Partial<AitDevtoolsState[K]>): void;
+  subscribe(listener: Listener): () => void;
+  /**
+   * 한 묶음의 update/patch 호출을 묶어 listener notify 1회로 만든다.
+   * preset 적용처럼 여러 슬라이스를 동시에 바꿀 때 panel re-render 폭주를
+   * 방지한다. 중첩 호출은 outermost transaction이 끝날 때 한 번만 notify
+   * (inner도 throw해도 outer finally가 flag를 복구한다).
+   *
+   * Rollback은 없다 — `fn`이 throw해도 그때까지의 state 변경은 유지된다.
+   * 구독자가 partial state를 영원히 못 보는 사고를 막기 위해, throw 여부와
+   * 무관하게 항상 한 번 notify한 뒤 throw를 propagate한다. DB transaction이
+   * 아니라 "여러 mutation을 한 notify로 묶는 batch"라고 생각하면 된다.
+   *
+   * Listener는 throw해선 안 된다 — finally 안의 `_notify()`가 throw하면 원래
+   * `fn`의 throw를 덮어버린다. 우리 구독자는 panel re-render뿐이라 실제
+   * 발생 사례는 없지만, 외부에서 listener를 등록할 때 주의.
+   */
+  transaction(fn: () => void): void;
+  /** 분석 로그 추가 */
+  logAnalytics(entry: Omit<AnalyticsLogEntry, "timestamp">): void;
+  /**
+   * SDK 호출 로그 추가 (ring buffer, 상한 SDK_CALL_LOG_MAX).
+   * `observe()`가 호출하고, proxy의 KNOWN_UNIMPLEMENTED 경로도 직접 호출한다.
+   */
+  logSdkCall(entry: AitSdkCall): void;
+  /** 이벤트 트리거 (backEvent, homeEvent 등) */
+  trigger(event: string): void;
+  reset(): void;
+  private _notify;
+}
+declare const aitState: AitStateManager;
+//#endregion
+//#region src/mock/presets.d.ts
+/**
+ * Preset이 덮어쓸 수 있는 mock state slice. 모든 키는 optional —
+ * 한 preset이 모든 분야를 정의할 필요 없다.
+ *
+ * 일부러 좁게 잡았다: viewport / brand / mockData / analyticsLog 등 QA 시나리오와
+ * 직접 관련 없는 영역은 preset 대상에서 제외한다 (preset 적용으로 unrelated state가
+ * 흔들리는 사고 방지). 필요해지면 추가.
+ *
+ * `iap` slice는 일부러 `nextResult`만 노출한다 — products / pendingOrders /
+ * completedOrders는 array/object 비교가 까다롭고 QA 시나리오에서 강제할 일이 거의
+ * 없다. `captureCurrentState` / `matchesPreset` 의 iap 처리 범위와 동기화.
+ */
+interface MockPresetState {
+  networkStatus?: AitDevtoolsState["networkStatus"];
+  permissions?: Partial<AitDevtoolsState["permissions"]>;
+  auth?: Partial<AitDevtoolsState["auth"]>;
+  iap?: {
+    nextResult?: AitDevtoolsState["iap"]["nextResult"];
+  };
+  ads?: Partial<AitDevtoolsState["ads"]>;
+  payment?: Partial<AitDevtoolsState["payment"]>;
+}
+interface MockPreset {
+  id: string;
+  label: string;
+  description?: string;
+  state: MockPresetState;
+}
+declare const builtInPresets: readonly MockPreset[];
+/**
+ * Preset state를 현재 `aitState`에 적용한다. 정의된 키만 덮어쓰고, 알지 못하는 키는
+ * 조용히 drop한다 (한 번 warn). 여러 슬라이스를 적용해도 listener notify는 한 번이다
+ * (`aitState.transaction` 사용 — panel re-render 폭주 방지).
+ */
+declare function applyPreset(state: MockPresetState): void;
+/**
+ * Preset의 모든 정의된 슬라이스가 현재 state와 일치하는지 검사. UI에서 dirty
+ * indicator를 그릴 때 쓴다.
+ *
+ * 일치한다 = preset이 정의한 키 전부가 그대로다. preset이 정의하지 않은 키는
+ * 비교 대상이 아니다 — preset은 partial이므로 다른 토글이 바뀌어도 dirty가 아니다.
+ */
+declare function matchesPreset(snapshot: AitDevtoolsState, preset: MockPresetState): boolean;
+/**
+ * 현재 state에서 preset에 저장할 만한 슬라이스를 추출. "save current as preset"에서 쓴다.
+ */
+declare function captureCurrentState(snapshot: AitDevtoolsState): MockPresetState;
+//#endregion
+//#region src/mock/preset-store.d.ts
+declare function listUserPresets(): MockPreset[];
+/**
+ * Preset을 저장한다. label에서 slug를 derive — 같은 slug가 이미 있으면 `-2`, `-3`
+ * suffix를 붙여 새 entry를 만든다 (기존 entry 덮어쓰기 아님). UI는 label만 받으면 된다.
+ *
+ * Throws:
+ * - label trim한 뒤 빈 문자열일 때
+ * - localStorage 미가용 환경일 때 (SSR 등)
+ * - `setItem` 실패 (`QuotaExceededError` 등) — caller가 처리해야 함
+ */
+declare function saveUserPreset(label: string, state: MockPresetState, description?: string): MockPreset;
+declare function deleteUserPreset(id: string): void;
+//#endregion
+//#region src/mock/safe-area-bridge.d.ts
+/** The postMessage envelope the launcher posts to the framed dev app (inset forward). */
+declare const SAFE_AREA_INSETS_MESSAGE_TYPE: "ait:safe-area-insets";
+/**
+ * The postMessage command the launcher partner bar's `←` button sends to the
+ * framed dev app (#510). The framed page calls `history.back()` in response.
+ *
+ * Protocol: only `{ type: 'ait:navigate-back' }` is valid. No other fields are
+ * read or acted on — extra fields are silently ignored by the shape guard.
+ * Game variant never sends this message (back button is partner-bar-only).
+ */
+declare const NAVIGATE_BACK_MESSAGE_TYPE: "ait:navigate-back";
+/**
+ * The postMessage envelope the framed mini-app self-reports its webViewType
+ * with (#580). The mini-app knows its own type from the build constant
+ * `__WEB_VIEW_TYPE__` (`granite.config.ts`'s `webViewProps.type`, injected by
+ * the devtools unplugin). The launcher is cross-origin so it cannot read that
+ * constant directly — the mini-app posts it to `window.parent` once so the
+ * launcher (env-2 PWA shell) switches to game mode automatically, with no
+ * manual `?navBarType=game` URL edit.
+ *
+ * Direction: this is the SEND side's contract (posted from inside the iframe by
+ * `@ait-co/debug-console`'s `packages/debug-console/src/attach.ts`). The
+ * launcher's receive half lives in
+ * `e2e/fixture/launcher/Launcher.tsx` and mirrors the same value enum inline,
+ * staying decoupled from the mock package internals — the same pattern the
+ * other launcher message types follow.
+ *
+ * Value enum: only `'partner'` and `'game'` are valid. The SDK's deprecated
+ * `'external'` alias of `partner` (web-framework 2.6.1) is mapped to `'partner'`
+ * at the send site so the wire only ever carries the two shapes the launcher
+ * emulates.
+ */
+declare const WEB_VIEW_TYPE_MESSAGE_TYPE: "ait:web-view-type";
+/** The two webViewType shapes the launcher can emulate (#580). */
+type WebViewTypeValue = "partner" | "game";
+/**
+ * Parse + validate a raw postMessage payload into a `SafeAreaInsets`, or return
+ * null when it is not a well-formed `ait:safe-area-insets` message. Pure — unit
+ * tested without a real MessageEvent.
+ */
+declare function parseSafeAreaInsetsMessage(data: unknown): SafeAreaInsets$1 | null;
+/**
+ * Parse + validate a raw postMessage payload into a webViewType value
+ * (`'partner'` | `'game'`), or return `null` when it is not a well-formed
+ * `ait:web-view-type` message (#580). Pure — unit tested without a real
+ * MessageEvent.
+ *
+ * Strict shape guard (the safety boundary for the cross-origin receive path):
+ * the payload must be a non-null object whose `type` is exactly
+ * {@link WEB_VIEW_TYPE_MESSAGE_TYPE} and whose `value` is exactly `'partner'`
+ * or `'game'` (an enum allow-list). Anything else — a foreign type, a missing
+ * or non-string value, the deprecated `'external'` alias, or any other string —
+ * returns `null` so a stray postMessage can never flip the launcher's visual
+ * mode. The send site is responsible for collapsing `'external'` → `'partner'`
+ * before posting; the parser does NOT silently accept it.
+ */
+declare function parseWebViewTypeMessage(data: unknown): WebViewTypeValue | null;
+/**
+ * Apply forwarded insets to the mock state. Skips the write (and the resulting
+ * subscribe notify) when nothing changed, so repeated identical messages from a
+ * resize storm don't churn subscribers.
+ */
+declare function applyForwardedSafeAreaInsets(insets: SafeAreaInsets$1): void;
+/**
+ * Install the window `message` listener that receives forwarded insets. Safe to
+ * call multiple times (idempotent) and a no-op outside a browser (SSR/jsdom
+ * without a window). Imported for its side effect by the mock barrel so any
+ * consumer that aliases `@apps-in-toss/web-framework` to the mock gets it wired.
+ *
+ * On each valid `ait:safe-area-insets` message:
+ * 1. Writes the corrected insets into the mock `SafeAreaInsets` state
+ *    (existing #484 behaviour — for apps that still read SDK insets).
+ * 2. Drives the env-2 dead-band compensation style via
+ *    {@link applyEnv2Compensation} — injects a `body { margin-top: calc(-1 *
+ *    env(safe-area-inset-top)) }` style when `top === 0` (partner mode) and
+ *    removes it when `top > 0` (game / full-bleed mode).
+ */
+declare function installSafeAreaInsetsBridge(): void;
+/**
+ * Parse a raw postMessage payload as an `ait:navigate-back` command.
+ *
+ * Returns true when the payload is a well-formed navigate-back command
+ * (`{ type: 'ait:navigate-back' }`), false otherwise. Pure — unit tested
+ * without a real MessageEvent.
+ *
+ * Shape guard: only the `type` field is inspected; any extra fields are
+ * ignored so future extensions do not break older receivers. The function
+ * does NOT read any data field beyond `type` — no sensitive values, no host
+ * disclosure (same principle as the insets bridge).
+ */
+declare function isNavigateBackMessage(data: unknown): boolean;
+/**
+ * Install the window `message` listener that handles `ait:navigate-back`
+ * commands (#510). When the launcher partner bar's `←` button is clicked it
+ * posts `{ type: 'ait:navigate-back' }` to the framed dev app; this listener
+ * calls `dispatchHostBackNavigation()` from the navigation module.
+ *
+ * Dispatch semantics: if there are any `graniteEvent.addEventListener('backEvent', …)`
+ * subscribers the CustomEvent `__ait:backEvent` is fired (same path as the env-1
+ * panel back button — the mini-app intercept channel). When there are no
+ * subscribers `history.back()` is called as the fallback. Back semantics are
+ * owned entirely by the navigation module; this bridge only delegates.
+ *
+ * Safe to call multiple times (idempotent) and a no-op outside a browser.
+ * Installed together with the inset bridge by `installBridges()` so any consumer
+ * of the mock barrel gets both wired automatically.
+ *
+ * No-op on apps that predate this bridge — the launcher posts the message but
+ * older mocks simply have no listener (harmless).
+ */
+declare function installNavigateBackBridge(): void;
+/**
+ * Install both env-2 postMessage bridges in one call (#484 insets + #510
+ * navigate-back). The mock barrel calls this at import time so consumers get
+ * all bridges wired without any explicit setup.
+ */
+declare function installBridges(): void;
+//#endregion
+export { Accuracy, type AitDevtoolsState, Analytics, type AnalyticsLogEntry, Clipboard, type ConsentedUserData, type ConsentedUserDataKey, type DeclaredAgeRange, Device, type DeviceApiMode, type DeviceModes, Environment, FetchAlbumPhotosPermissionError, FetchContactsPermissionError, File, Game, GetClipboardTextPermissionError, GetCurrentLocationPermissionError, GoogleAdMob, type HapticFeedbackType, IAP, type IapNextResult, type LocationCoords, type MockContact, type MockData, type MockIapProduct, type MockLocation, type MockPreset, type MockPresetState, NAVIGATE_BACK_MESSAGE_TYPE, type NetworkStatus, Notification, OpenCameraPermissionError, type OperationalEnvironment, PermissionError, type PermissionName, type PermissionStatus, type PlatformOS, type Primitive, Promotion, Review, SAFE_AREA_INSETS_MESSAGE_TYPE, SafeArea, SafeAreaInsets, type SafeAreaInsets$1 as SafeAreaInsetsType, Screen, SetClipboardTextPermissionError, Share, StartUpdateLocationPermissionError, Storage, TossAds, TossAuth, TossPay, User, WEB_VIEW_TYPE_MESSAGE_TYPE, type WebViewTypeValue, aitState, appLogin, applyForwardedSafeAreaInsets, applyPreset, appsInTossEvent, appsInTossSignTossCert, builtInPresets, captureCurrentState, checkoutPayment, closeView, contactsViral, createAsyncBridge, createConstantBridge, createEventBridge, deleteUserPreset, env, eventLog, fetchAlbumItems, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getAppsInTossGlobals, getClipboardText, getConsentedUserData, getCurrentLocation, getDeclaredAgeRange, getDefaultPlaceholderImages, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPermission, getPlatformOS, getSafeAreaInsets, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, graniteEvent, grantPromotionReward, grantPromotionRewardForGame, installBridges, installNavigateBackBridge, installSafeAreaInsetsBridge, isMinVersionSupported, isNavigateBackMessage, listUserPresets, loadFullScreenAd, matchesPreset, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openPDFViewer, openPermissionDialog, openURL, parseSafeAreaInsetsMessage, parseWebViewTypeMessage, partner, requestNotificationAgreement, requestPermission, requestReview, requestTossPayPaysBilling, saveBase64Data, saveUserPreset, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, showFullScreenAd, startUpdateLocation, submitGameCenterLeaderBoardScore, tdsEvent };