@ait-co/devtools 0.1.73 → 0.1.75

package/dist/mock/index.js

@@ -238,1073 +238,1312 @@ if (!globalRef[SINGLETON_KEY]) globalRef[SINGLETON_KEY] = new AitStateManager();
 const aitState = globalRef[SINGLETON_KEY];
 if (typeof window !== "undefined") window.__ait = aitState;
 //#endregion
-//#region src/mock/safe-area-bridge.ts
+//#region src/mock/device/_helpers.ts
 /**
-* env-2 safe-area inset bridge (#484, slice 2).
-*
-* In the AITC Sandbox PWA (env 2) the dev app runs inside the launcher's
-* full-viewport `<iframe>`. The launcher is the top-level document, so its
-* `env(safe-area-inset-*)` measurement is the ground truth for the real device
-* geometry. The framed page's mock would otherwise report a synthetic preset
-* value (e.g. top=54), which sdk-example then double-pads on top of a viewport
-* that already starts below the status bar — the env-2 "dead band" defect.
-*
-* The launcher forwards its measured insets to the framed page with
-* `postMessage({ type: 'ait:safe-area-insets', insets })` (on iframe load and on
-* resize/orientationchange). This module installs the receive half: it validates
-* the envelope and writes the real insets into the mock `SafeAreaInsets` state,
-* which fires the existing subscribe path (see navigation/index.ts) so apps that
-* subscribe re-read the corrected values.
-*
-* Origin: the inset values are non-sensitive geometry (four small numbers), so
-* we do NOT restrict by origin — the launcher posts cross-origin from a
-* *.trycloudflare.com tunnel with targetOrigin '*'. Shape + range validation is
-* still mandatory: a malformed or out-of-range message is silently ignored so a
-* stray postMessage from any frame can never corrupt the mock state.
-*
-* Message-driven by design: env 1 (desktop browser, no launcher) never receives
-* this message, so the panel preset stays authoritative there with zero special
-* casing here.
+* 디바이스 모듈 내부 공유 헬퍼
 */
-/** The postMessage envelope the launcher posts to the framed dev app. */
-const SAFE_AREA_INSETS_MESSAGE_TYPE = "ait:safe-area-insets";
-const MAX_INSET_PX = 200;
-function isValidInset(value) {
-	return typeof value === "number" && Number.isFinite(value) && value >= 0 && value <= MAX_INSET_PX;
+function generatePlaceholderImage(width, height, text, color) {
+	const canvas = document.createElement("canvas");
+	canvas.width = width;
+	canvas.height = height;
+	const ctx = canvas.getContext("2d");
+	if (!ctx) {
+		const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}"><rect fill="${color}" width="${width}" height="${height}"/><text x="50%" y="50%" fill="white" font-size="16" text-anchor="middle" dominant-baseline="middle">${text}</text></svg>`;
+		return `data:image/svg+xml;base64,${btoa(svg)}`;
+	}
+	ctx.fillStyle = color;
+	ctx.fillRect(0, 0, width, height);
+	ctx.fillStyle = "white";
+	ctx.font = "16px sans-serif";
+	ctx.textAlign = "center";
+	ctx.textBaseline = "middle";
+	ctx.fillText(text, width / 2, height / 2);
+	return canvas.toDataURL("image/png");
 }
-/**
-* 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.
-*/
-function parseSafeAreaInsetsMessage(data) {
-	if (typeof data !== "object" || data === null) return null;
-	if (data.type !== "ait:safe-area-insets") return null;
-	const insets = data.insets;
-	if (typeof insets !== "object" || insets === null) return null;
-	const { top, bottom, left, right } = insets;
-	if (!isValidInset(top) || !isValidInset(bottom) || !isValidInset(left) || !isValidInset(right)) return null;
-	return {
-		top,
-		bottom,
-		left,
-		right
-	};
+const DEFAULT_PLACEHOLDERS = [
+	{
+		text: "Mock Photo 1",
+		color: "#3182F6"
+	},
+	{
+		text: "Mock Photo 2",
+		color: "#27ae60"
+	},
+	{
+		text: "Mock Photo 3",
+		color: "#e67e22"
+	}
+];
+let cachedPlaceholders = null;
+function getDefaultPlaceholderImages() {
+	if (!cachedPlaceholders) cachedPlaceholders = DEFAULT_PLACEHOLDERS.map((p) => generatePlaceholderImage(320, 240, p.text, p.color));
+	return [...cachedPlaceholders];
 }
-/**
-* 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.
-*/
-function applyForwardedSafeAreaInsets(insets) {
-	const current = aitState.state.safeAreaInsets;
-	if (current.top === insets.top && current.bottom === insets.bottom && current.left === insets.left && current.right === insets.right) return;
-	aitState.update({ safeAreaInsets: insets });
+/** @internal device 모듈 내부 전용 */
+function getMockImages() {
+	const images = aitState.state.mockData.images;
+	if (images.length > 0) return images;
+	return getDefaultPlaceholderImages();
 }
-let installed = false;
-/**
-* 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.
-*/
-function installSafeAreaInsetsBridge() {
-	if (installed || typeof window === "undefined") return;
-	installed = true;
-	window.addEventListener("message", (event) => {
-		const insets = parseSafeAreaInsetsMessage(event.data);
-		if (insets) applyForwardedSafeAreaInsets(insets);
+const PROMPT_TIMEOUT_MS = 3e4;
+/** @internal device 모듈 내부 전용 */
+function waitForPromptResponse(type) {
+	return new Promise((resolve, reject) => {
+		const eventName = `__ait:prompt-response:${type}`;
+		const cancelName = "__ait:prompt-cancel";
+		function cleanup() {
+			clearTimeout(timer);
+			window.removeEventListener(eventName, handler);
+			window.removeEventListener(cancelName, cancelHandler);
+		}
+		const timer = setTimeout(() => {
+			cleanup();
+			const hint = !!document.querySelector(".ait-panel") ? "Please provide input via the DevTools panel." : "Is @ait-co/devtools/panel imported?";
+			reject(/* @__PURE__ */ new Error(`[@ait-co/devtools] Prompt timeout for "${type}" after ${PROMPT_TIMEOUT_MS / 1e3}s. ${hint}`));
+		}, PROMPT_TIMEOUT_MS);
+		const handler = (e) => {
+			cleanup();
+			resolve(e.detail);
+		};
+		const cancelHandler = () => {
+			cleanup();
+			reject(/* @__PURE__ */ new Error(`[@ait-co/devtools] Prompt cancelled for "${type}"`));
+		};
+		window.addEventListener(eventName, handler);
+		window.addEventListener(cancelName, cancelHandler);
+		window.dispatchEvent(new CustomEvent("__ait:prompt-request", { detail: { type } }));
 	});
 }
 //#endregion
-//#region src/mock/observe.ts
+//#region src/mock/permissions.ts
 /**
-* fn을 observe로 감싼다.
-*
-* @param apiName  - 로그에 기록할 SDK 메서드 이름 (예: `'setScreenAwakeMode'`)
-* @param fidelity - 이 mock의 fidelity grade ('faithful' | 'partial' | 'inert')
-* @param fn       - 실제 mock 구현체. 시그니처를 그대로 통과시킨다.
-* @returns fn과 동일한 타입의 래퍼 함수
+* 권한 시스템 mock
+* 각 디바이스 API (.getPermission, .openPermissionDialog)에 부착된다.
 */
-function observe(apiName, fidelity, fn) {
-	return (...args) => {
-		const timestamp = Date.now();
-		const safeArgs = args.map((a) => safeSerialize(a));
-		const result = fn(...args);
-		if (result instanceof Promise) {
-			aitState.logSdkCall({
-				method: apiName,
-				args: safeArgs,
-				timestamp,
-				status: "pending",
-				fidelity
-			});
-			result.then((value) => {
-				aitState.logSdkCall({
-					method: apiName,
-					args: safeArgs,
-					timestamp,
-					status: "resolved",
-					result: safeSerialize(value),
-					fidelity
-				});
-			}, (err) => {
-				aitState.logSdkCall({
-					method: apiName,
-					args: safeArgs,
-					timestamp,
-					status: "rejected",
-					error: err instanceof Error ? err.message : String(err),
-					fidelity
-				});
-			});
-			return result;
-		}
-		aitState.logSdkCall({
-			method: apiName,
-			args: safeArgs,
-			timestamp,
-			status: "resolved",
-			result: safeSerialize(result),
-			fidelity
-		});
-		return result;
-	};
-}
 /**
-* 값을 JSON-safe한 형태로 변환한다.
-* - null / primitive — 그대로.
-* - 함수 — `'[Function: name]'` 문자열.
-* - 기타 객체 — JSON.stringify 실패 시 `'[unserializable]'`.
+* web-framework 3.0+ 권한 에러 기반 클래스.
+* `instanceof PermissionError`로 체크하는 코드와 호환된다.
 */
-function safeSerialize(value) {
-	if (value === null || value === void 0) return value;
-	if (typeof value === "function") return `[Function: ${value.name || "anonymous"}]`;
-	if (typeof value !== "object") return value;
-	try {
-		return JSON.parse(JSON.stringify(value));
-	} catch {
-		return "[unserializable]";
+var PermissionError = class extends Error {
+	constructor({ methodName, message }) {
+		super(message ?? `${methodName}: permission denied`);
+		this.name = `${methodName}PermissionError`;
 	}
-}
-//#endregion
-//#region src/mock/proxy.ts
+};
+/** openCamera 권한 에러 */
+var OpenCameraPermissionError = class extends PermissionError {
+	constructor() {
+		super({ methodName: "openCamera" });
+	}
+};
+/** fetchAlbumPhotos 권한 에러 */
+var FetchAlbumPhotosPermissionError = class extends PermissionError {
+	constructor() {
+		super({ methodName: "fetchAlbumPhotos" });
+	}
+};
+/** fetchContacts 권한 에러 */
+var FetchContactsPermissionError = class extends PermissionError {
+	constructor() {
+		super({ methodName: "fetchContacts" });
+	}
+};
+/** getCurrentLocation 권한 에러 */
+var GetCurrentLocationPermissionError = class extends PermissionError {
+	constructor() {
+		super({ methodName: "getCurrentLocation" });
+	}
+};
+/** getClipboardText 권한 에러 */
+var GetClipboardTextPermissionError = class extends PermissionError {
+	constructor() {
+		super({ methodName: "getClipboardText" });
+	}
+};
+/** setClipboardText 권한 에러 */
+var SetClipboardTextPermissionError = class extends PermissionError {
+	constructor() {
+		super({ methodName: "setClipboardText" });
+	}
+};
 /**
-* 미구현 API용 Proxy 트립와이어.
-*
-* 미구현 프로퍼티에 접근하면 throw한다. 이는 "devtools에서는 멀쩡히 돌지만
-* 실 SDK에선 실제로 동작하는" 시나리오를 차단하기 위한 의도적 선택이다.
-* mock이 미구현인 API는 실 SDK에서는 존재할 수 있고, 사용자가 이를 인지하지
-* 못한 채 개발을 이어가면 배포 시점에 놀라게 된다. 에러 메시지에 이슈 URL을
-* 포함해 사용자가 mock 누락을 제보할 수 있게 한다.
-*
-* ## KNOWN_UNIMPLEMENTED 정책
-* SDK에 존재하는 것으로 알려져 있으나 현재 mock이 없는 API 이름만 이 집합에 둔다.
-* 이 경우에만 throw 대신 🔴 inert no-op을 반환하고 sdkCallLog에 기록한다.
-* 완전히 미지의 이름은 여전히 throw — "잘 되는 척" 방지.
+* startUpdateLocation 권한 에러.
+* web-framework 3.0에서 GetCurrentLocationPermissionError의 alias.
 */
-const ISSUES_URL = "https://github.com/apps-in-toss-community/devtools/issues";
-/**
-* SDK에 존재하나 mock이 아직 없는 것으로 확인된 이름 목록.
-* 새 API가 SDK에 추가되면 여기에 추가하고 별도 PR에서 mock 구현으로 이동한다.
-* 확인되지 않은 이름은 절대 여기에 추가하지 않는다 — throw가 더 안전하다.
+const StartUpdateLocationPermissionError = GetCurrentLocationPermissionError;
+const permissionErrorMap = {
+	openCamera: OpenCameraPermissionError,
+	fetchAlbumPhotos: FetchAlbumPhotosPermissionError,
+	fetchAlbumItems: FetchAlbumPhotosPermissionError,
+	fetchContacts: FetchContactsPermissionError,
+	getCurrentLocation: GetCurrentLocationPermissionError,
+	getClipboardText: GetClipboardTextPermissionError,
+	setClipboardText: SetClipboardTextPermissionError
+};
+async function getPermission(name) {
+	return aitState.state.permissions[name];
+}
+async function openPermissionDialog(name) {
+	if (aitState.state.permissions[name] === "allowed") return "allowed";
+	aitState.patch("permissions", { [name]: "allowed" });
+	return "allowed";
+}
+async function requestPermission(permission) {
+	return openPermissionDialog(permission.name);
+}
+/** 권한이 필요한 함수에 .getPermission(), .openPermissionDialog()를 부착 */
+function withPermission(fn, permissionName) {
+	const enhanced = fn;
+	enhanced.getPermission = () => getPermission(permissionName);
+	enhanced.openPermissionDialog = () => openPermissionDialog(permissionName);
+	return enhanced;
+}
+/**
+* 권한 체크 후 denied면 per-API *PermissionError 서브클래스를 throw한다.
+* 실 3.0 SDK 동작과 일치 — `instanceof PermissionError` 분기가 mock에서도 동작한다 (#372).
 */
-const KNOWN_UNIMPLEMENTED = /* @__PURE__ */ new Set([]);
-function createMockProxy(moduleName, implementations) {
-	return new Proxy(implementations, { get(target, prop) {
-		if (typeof prop === "symbol") return void 0;
-		if (prop in target) return target[prop];
-		const name = String(prop);
-		if (KNOWN_UNIMPLEMENTED.has(name)) return (...args) => {
-			console.warn(`[@ait-co/devtools] ${moduleName}.${name} is known-unimplemented (🔴 inert). Returning undefined. Please file or upvote an issue: ${ISSUES_URL}`);
-			aitState.logSdkCall({
-				method: `${moduleName}.${name}`,
-				args,
-				timestamp: Date.now(),
-				status: "resolved",
-				result: void 0,
-				fidelity: "inert"
-			});
-		};
-		throw new Error(`[@ait-co/devtools] ${moduleName}.${prop} is not mocked. This API may exist in @apps-in-toss/web-framework, but devtools' mock does not cover it yet. Please file an issue: ${ISSUES_URL}`);
-	} });
+function checkPermission(name, fnName) {
+	if (aitState.state.permissions[name] === "denied") {
+		const ErrorClass = permissionErrorMap[fnName];
+		if (ErrorClass) throw new ErrorClass();
+		throw new PermissionError({ methodName: fnName });
+	}
 }
 //#endregion
-//#region src/mock/ads/index.ts
+//#region src/mock/device/camera.ts
 /**
-* 광고 mock (GoogleAdMob, TossAds, FullScreenAd)
-*
-* 변경 이력 (#196):
-* - slot 레지스트리로 TossAds destroy/destroyAll 누수 수정 (🟡→🟢)
-* - attachBanner BannerSlotCallbacks 발화 (onAdRendered/onAdImpression/onNoFill 등)
-* - initialize onInitialized/onInitializationFailed 발화
-* - AdMob reward 파라미터화 (state.ads.rewardUnitType/rewardAmount)
-* - 모든 호출 observe()로 sdkCallLog에 기록
+* Camera & Album Photos & Album Items mock
+* mock/web/prompt 모드 지원
 */
-function withIsSupported(fn) {
-	fn.isSupported = () => true;
-	return fn;
-}
-const _slotRegistry = /* @__PURE__ */ new Map();
-let _slotCounter = 0;
-function _nextSlotId(adGroupId) {
-	_slotCounter += 1;
-	return `mock-slot-${adGroupId}-${_slotCounter}`;
+async function openCameraMock() {
+	const images = getMockImages();
+	return {
+		id: crypto.randomUUID(),
+		dataUri: images[0]
+	};
 }
-const GoogleAdMob = createMockProxy("GoogleAdMob", {
-	loadAppsInTossAdMob: withIsSupported(observe("GoogleAdMob.loadAppsInTossAdMob", "faithful", (args) => {
-		setTimeout(() => {
-			if (aitState.state.ads.forceNoFill) {
-				args.onError(/* @__PURE__ */ new Error("No fill"));
+async function openCameraWeb() {
+	return new Promise((resolve, reject) => {
+		const input = document.createElement("input");
+		input.type = "file";
+		input.accept = "image/*";
+		input.capture = "environment";
+		let settled = false;
+		input.onchange = () => {
+			settled = true;
+			const file = input.files?.[0];
+			if (!file) {
+				reject(/* @__PURE__ */ new Error("No file selected"));
 				return;
 			}
-			aitState.patch("ads", { isLoaded: true });
-			args.onEvent({
-				type: "loaded",
-				data: { adGroupId: args.options?.adGroupId }
-			});
-		}, 200);
-		return () => {};
-	})),
-	showAppsInTossAdMob: withIsSupported(observe("GoogleAdMob.showAppsInTossAdMob", "faithful", (args) => {
-		if (!aitState.state.ads.isLoaded) {
-			args.onError(/* @__PURE__ */ new Error("Ad not loaded"));
-			return () => {};
-		}
-		setTimeout(() => args.onEvent({ type: "requested" }), 50);
-		setTimeout(() => args.onEvent({ type: "show" }), 100);
-		setTimeout(() => args.onEvent({ type: "impression" }), 150);
-		setTimeout(() => {
-			const { rewardUnitType, rewardAmount } = aitState.state.ads;
-			args.onEvent({
-				type: "userEarnedReward",
-				data: {
-					unitType: rewardUnitType,
-					unitAmount: rewardAmount
-				}
+			const reader = new FileReader();
+			reader.onload = () => resolve({
+				id: crypto.randomUUID(),
+				dataUri: reader.result
 			});
-		}, 1e3);
-		setTimeout(() => {
-			args.onEvent({ type: "dismissed" });
-			aitState.patch("ads", { isLoaded: false });
-		}, 1500);
-		return () => {};
-	})),
-	isAppsInTossAdMobLoaded: withIsSupported(observe("GoogleAdMob.isAppsInTossAdMobLoaded", "faithful", async (_options) => aitState.state.ads.isLoaded))
-});
-const TossAds = createMockProxy("TossAds", {
-	initialize: withIsSupported(observe("TossAds.initialize", "partial", (options) => {
-		if (aitState.state.ads.forceNoFill) {
-			options.callbacks?.onInitializationFailed?.(/* @__PURE__ */ new Error("No fill"));
-			return;
-		}
-		options.callbacks?.onInitialized?.();
-	})),
-	attach: withIsSupported(observe("TossAds.attach", "partial", (_adGroupId, target, _options) => {
-		const el = typeof target === "string" ? document.querySelector(target) : target;
-		if (el) {
-			const placeholder = document.createElement("div");
-			placeholder.style.cssText = "background:#f0f0f0;border:1px dashed #999;padding:16px;text-align:center;color:#666;font-size:14px;";
-			placeholder.textContent = "[@ait-co/devtools] TossAds Placeholder";
-			el.appendChild(placeholder);
-		}
-	})),
-	attachBanner: withIsSupported(observe("TossAds.attachBanner", "faithful", (adGroupId, target, options) => {
-		const el = typeof target === "string" ? document.querySelector(target) : target;
-		const slotId = _nextSlotId(adGroupId);
-		const placeholder = document.createElement("div");
-		const theme = options?.theme ?? "auto";
-		const variant = options?.variant ?? "card";
-		const isDark = theme === "dark" || theme === "auto" && typeof window !== "undefined" && window.matchMedia?.("(prefers-color-scheme: dark)").matches;
-		const bg = isDark ? "#1a1a1a" : "#f0f0f0";
-		const textColor = isDark ? "#aaa" : "#666";
-		const borderColor = isDark ? "#555" : "#999";
-		const height = variant === "expanded" ? "120px" : "60px";
-		placeholder.dataset.aitSlotId = slotId;
-		placeholder.style.cssText = `background:${bg};border:1px dashed ${borderColor};padding:8px 12px;text-align:center;color:${textColor};font-size:12px;min-height:${height};display:flex;align-items:center;justify-content:center;`;
-		placeholder.textContent = `[@ait-co/devtools] Banner Ad (${variant})`;
-		if (el) {
-			el.appendChild(placeholder);
-			_slotRegistry.set(slotId, placeholder);
-		}
-		const destroySlot = () => {
-			const registered = _slotRegistry.get(slotId);
-			if (registered) {
-				registered.remove();
-				_slotRegistry.delete(slotId);
-			}
+			reader.onerror = () => reject(/* @__PURE__ */ new Error("Failed to read file"));
+			reader.readAsDataURL(file);
 		};
-		setTimeout(() => {
-			if (aitState.state.ads.forceNoFill) {
-				options?.callbacks?.onNoFill?.({
-					slotId,
-					adGroupId,
-					adMetadata: {}
-				});
-				options?.callbacks?.onAdFailedToRender?.({
-					slotId,
-					adGroupId,
-					adMetadata: {},
-					error: {
-						code: 0,
-						message: "No fill"
-					}
-				});
+		const onFocus = () => {
+			setTimeout(() => {
+				if (!settled) reject(/* @__PURE__ */ new Error("File picker cancelled"));
+				window.removeEventListener("focus", onFocus);
+			}, 300);
+		};
+		window.addEventListener("focus", onFocus);
+		input.click();
+	});
+}
+async function openCameraPrompt() {
+	const dataUri = await waitForPromptResponse("camera");
+	return {
+		id: crypto.randomUUID(),
+		dataUri
+	};
+}
+const _openCamera = async (_options) => {
+	checkPermission("camera", "openCamera");
+	const mode = aitState.state.deviceModes.camera;
+	if (mode === "web") return openCameraWeb();
+	if (mode === "prompt") return openCameraPrompt();
+	return openCameraMock();
+};
+const openCamera = withPermission(_openCamera, "camera");
+async function fetchAlbumPhotosMock(maxCount) {
+	return getMockImages().slice(0, maxCount).map((dataUri) => ({
+		id: crypto.randomUUID(),
+		dataUri
+	}));
+}
+async function fetchAlbumPhotosWeb(maxCount) {
+	return new Promise((resolve, reject) => {
+		const input = document.createElement("input");
+		input.type = "file";
+		input.accept = "image/*";
+		input.multiple = true;
+		let settled = false;
+		input.onchange = async () => {
+			settled = true;
+			const files = Array.from(input.files ?? []).slice(0, maxCount);
+			if (files.length === 0) {
+				reject(/* @__PURE__ */ new Error("No files selected"));
 				return;
 			}
-			const eventPayload = {
-				slotId,
-				adGroupId,
-				adMetadata: {
-					creativeId: `mock-creative-${slotId}`,
-					requestId: `mock-req-${slotId}`
-				}
-			};
-			options?.callbacks?.onAdRendered?.(eventPayload);
-			options?.callbacks?.onAdImpression?.(eventPayload);
-		}, 100);
-		return { destroy: destroySlot };
-	})),
-	destroy: withIsSupported(observe("TossAds.destroy", "faithful", (slotId) => {
-		const el = _slotRegistry.get(slotId);
-		if (el) {
-			el.remove();
-			_slotRegistry.delete(slotId);
-		}
-	})),
-	destroyAll: withIsSupported(observe("TossAds.destroyAll", "faithful", () => {
-		for (const el of _slotRegistry.values()) el.remove();
-		_slotRegistry.clear();
-	}))
-});
-const loadFullScreenAd = withIsSupported(observe("loadFullScreenAd", "faithful", (args) => {
-	setTimeout(() => {
-		if (aitState.state.ads.forceNoFill) {
-			args.onError(/* @__PURE__ */ new Error("No fill"));
-			return;
-		}
-		aitState.patch("ads", { isLoaded: true });
-		args.onEvent({
-			type: "loaded",
-			data: { adGroupId: args.options?.adGroupId }
-		});
-	}, 200);
-	return () => {};
-}));
-const showFullScreenAd = withIsSupported(observe("showFullScreenAd", "faithful", (args) => {
-	if (!aitState.state.ads.isLoaded) {
-		args.onError(/* @__PURE__ */ new Error("Ad not loaded"));
-		return () => {};
-	}
-	setTimeout(() => args.onEvent({ type: "show" }), 100);
-	setTimeout(() => args.onEvent({ type: "dismissed" }), 1500);
-	return () => {};
-}));
+			resolve(await Promise.all(files.map((file) => new Promise((res, rej) => {
+				const reader = new FileReader();
+				reader.onload = () => res({
+					id: crypto.randomUUID(),
+					dataUri: reader.result
+				});
+				reader.onerror = () => rej(/* @__PURE__ */ new Error("Failed to read file"));
+				reader.readAsDataURL(file);
+			}))));
+		};
+		const onFocus = () => {
+			setTimeout(() => {
+				if (!settled) reject(/* @__PURE__ */ new Error("File picker cancelled"));
+				window.removeEventListener("focus", onFocus);
+			}, 300);
+		};
+		window.addEventListener("focus", onFocus);
+		input.click();
+	});
+}
+async function fetchAlbumPhotosPrompt(maxCount) {
+	return (await waitForPromptResponse("photos")).slice(0, maxCount).map((dataUri) => ({
+		id: crypto.randomUUID(),
+		dataUri
+	}));
+}
+const _fetchAlbumPhotos = async (options) => {
+	checkPermission("photos", "fetchAlbumPhotos");
+	const maxCount = options?.maxCount ?? 10;
+	const mode = aitState.state.deviceModes.photos;
+	if (mode === "web") return fetchAlbumPhotosWeb(maxCount);
+	if (mode === "prompt") return fetchAlbumPhotosPrompt(maxCount);
+	return fetchAlbumPhotosMock(maxCount);
+};
+const fetchAlbumPhotos = withPermission(_fetchAlbumPhotos, "photos");
+async function fetchAlbumItemsMock(maxCount, types) {
+	return getMockImages().slice(0, maxCount).filter(() => types.includes("PHOTO")).map((dataUri) => ({
+		id: crypto.randomUUID(),
+		dataUri,
+		type: "PHOTO"
+	}));
+}
+async function fetchAlbumItemsWeb(maxCount, types) {
+	return new Promise((resolve) => {
+		const input = document.createElement("input");
+		input.type = "file";
+		input.accept = types.includes("VIDEO") ? "image/*,video/*" : "image/*";
+		input.multiple = true;
+		let settled = false;
+		input.onchange = async () => {
+			settled = true;
+			const files = Array.from(input.files ?? []).slice(0, maxCount);
+			if (files.length === 0) {
+				resolve([]);
+				return;
+			}
+			resolve(await Promise.all(files.map((file) => new Promise((res, rej) => {
+				const itemType = file.type.startsWith("video/") ? "VIDEO" : "PHOTO";
+				const reader = new FileReader();
+				reader.onload = () => res({
+					id: crypto.randomUUID(),
+					dataUri: reader.result,
+					type: itemType
+				});
+				reader.onerror = () => rej(/* @__PURE__ */ new Error("Failed to read file"));
+				reader.readAsDataURL(file);
+			}))));
+		};
+		const onFocus = () => {
+			setTimeout(() => {
+				if (!settled) resolve([]);
+				window.removeEventListener("focus", onFocus);
+			}, 300);
+		};
+		window.addEventListener("focus", onFocus);
+		input.click();
+	});
+}
+async function fetchAlbumItemsPrompt(maxCount) {
+	return (await waitForPromptResponse("photos")).slice(0, maxCount).map((dataUri) => ({
+		id: crypto.randomUUID(),
+		dataUri,
+		type: "PHOTO"
+	}));
+}
+const _fetchAlbumItems = async (options) => {
+	checkPermission("photos", "fetchAlbumItems");
+	const maxCount = options?.maxCount ?? 10;
+	const types = options?.types ?? ["PHOTO"];
+	const mode = aitState.state.deviceModes.photos;
+	if (mode === "web") return fetchAlbumItemsWeb(maxCount, types);
+	if (mode === "prompt") return fetchAlbumItemsPrompt(maxCount);
+	return fetchAlbumItemsMock(maxCount, types);
+};
+const fetchAlbumItems = withPermission(_fetchAlbumItems, "photos");
 //#endregion
-//#region src/mock/analytics/index.ts
+//#region src/mock/device/clipboard.ts
 /**
-* Analytics mock
+* Clipboard mock
+* mock/web 모드 지원
 */
-const Analytics = {
-	screen: (params) => {
-		aitState.logAnalytics({
-			type: "screen",
-			params: params ?? {}
-		});
-		return Promise.resolve();
-	},
-	impression: (params) => {
-		aitState.logAnalytics({
-			type: "impression",
-			params: params ?? {}
-		});
-		return Promise.resolve();
-	},
-	click: (params) => {
-		aitState.logAnalytics({
-			type: "click",
-			params: params ?? {}
-		});
-		return Promise.resolve();
+const _getClipboardText = async () => {
+	checkPermission("clipboard", "getClipboardText");
+	if (aitState.state.deviceModes.clipboard === "mock") return aitState.state.mockData.clipboardText;
+	try {
+		return await navigator.clipboard.readText();
+	} catch {
+		return "";
 	}
 };
-async function eventLog(params) {
-	aitState.logAnalytics({
-		type: params.log_type,
-		params: {
-			log_name: params.log_name,
-			...params.params
-		}
-	});
-}
+const getClipboardText = withPermission(_getClipboardText, "clipboard");
+const _setClipboardText = async (text) => {
+	checkPermission("clipboard", "setClipboardText");
+	if (aitState.state.deviceModes.clipboard === "mock") {
+		aitState.patch("mockData", { clipboardText: text });
+		return;
+	}
+	await navigator.clipboard.writeText(text);
+};
+const setClipboardText = withPermission(_setClipboardText, "clipboard");
 //#endregion
-//#region src/mock/auth/index.ts
+//#region src/mock/device/contacts.ts
 /**
-* 인증/로그인 mock
+* Contacts mock
 */
-async function appLogin() {
-	return {
-		authorizationCode: `mock-auth-${crypto.randomUUID()}`,
-		referrer: aitState.state.environment === "toss" ? "DEFAULT" : "SANDBOX"
-	};
-}
-async function getIsTossLoginIntegratedService() {
-	return aitState.state.auth.isTossLoginIntegrated;
-}
-async function getUserKeyForGame() {
-	if (!aitState.state.auth.userKeyHash) return void 0;
-	return {
-		hash: aitState.state.auth.userKeyHash,
-		type: "HASH"
-	};
-}
-async function getAnonymousKey() {
-	if (!aitState.state.auth.anonymousKeyHash) return void 0;
+const _fetchContacts = async (options) => {
+	checkPermission("contacts", "fetchContacts");
+	let contacts = aitState.state.contacts;
+	if (options.query?.contains) {
+		const q = options.query.contains.toLowerCase();
+		contacts = contacts.filter((c) => c.name.toLowerCase().includes(q) || c.phoneNumber.includes(q));
+	}
+	const sliced = contacts.slice(options.offset, options.offset + options.size);
+	const nextOffset = options.offset + options.size;
 	return {
-		hash: aitState.state.auth.anonymousKeyHash,
-		type: "HASH"
+		result: sliced,
+		nextOffset: nextOffset < contacts.length ? nextOffset : null,
+		done: nextOffset >= contacts.length
 	};
-}
-async function appsInTossSignTossCert(_params) {
-	console.log("[@ait-co/devtools] appsInTossSignTossCert called (no-op in mock)");
-}
+};
+const fetchContacts = withPermission(_fetchContacts, "contacts");
 //#endregion
-//#region src/mock/device/_helpers.ts
+//#region src/mock/device/haptic.ts
 /**
-* 디바이스 모듈 내부 공유 헬퍼
+* Haptic Feedback & saveBase64Data mock
+*
+* generateHapticFeedback — 영역 3 (하드웨어 API 관측):
+*   - 10종 HapticFeedbackType을 navigator.vibrate 패턴으로 매핑(근사, best-effort).
+*   - `typeof navigator.vibrate === 'function'` 가드 — API 없는 환경에서 throw 없이 skip.
+*   - sdkCallLog에 🟡(partial)로 기록. params: { hapticType, vibrated: boolean }.
+*   - 시그니처 불변 — __typecheck.ts의 Assert<Mock, Original> 통과.
 */
-function generatePlaceholderImage(width, height, text, color) {
-	const canvas = document.createElement("canvas");
-	canvas.width = width;
-	canvas.height = height;
-	const ctx = canvas.getContext("2d");
-	if (!ctx) {
-		const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}"><rect fill="${color}" width="${width}" height="${height}"/><text x="50%" y="50%" fill="white" font-size="16" text-anchor="middle" dominant-baseline="middle">${text}</text></svg>`;
-		return `data:image/svg+xml;base64,${btoa(svg)}`;
-	}
-	ctx.fillStyle = color;
-	ctx.fillRect(0, 0, width, height);
-	ctx.fillStyle = "white";
-	ctx.font = "16px sans-serif";
-	ctx.textAlign = "center";
-	ctx.textBaseline = "middle";
-	ctx.fillText(text, width / 2, height / 2);
-	return canvas.toDataURL("image/png");
-}
-const DEFAULT_PLACEHOLDERS = [
-	{
-		text: "Mock Photo 1",
-		color: "#3182F6"
-	},
-	{
-		text: "Mock Photo 2",
-		color: "#27ae60"
-	},
-	{
-		text: "Mock Photo 3",
-		color: "#e67e22"
-	}
-];
-let cachedPlaceholders = null;
-function getDefaultPlaceholderImages() {
-	if (!cachedPlaceholders) cachedPlaceholders = DEFAULT_PLACEHOLDERS.map((p) => generatePlaceholderImage(320, 240, p.text, p.color));
-	return [...cachedPlaceholders];
-}
-/** @internal device 모듈 내부 전용 */
-function getMockImages() {
-	const images = aitState.state.mockData.images;
-	if (images.length > 0) return images;
-	return getDefaultPlaceholderImages();
-}
-const PROMPT_TIMEOUT_MS = 3e4;
-/** @internal device 모듈 내부 전용 */
-function waitForPromptResponse(type) {
-	return new Promise((resolve, reject) => {
-		const eventName = `__ait:prompt-response:${type}`;
-		const cancelName = "__ait:prompt-cancel";
-		function cleanup() {
-			clearTimeout(timer);
-			window.removeEventListener(eventName, handler);
-			window.removeEventListener(cancelName, cancelHandler);
-		}
-		const timer = setTimeout(() => {
-			cleanup();
-			const hint = !!document.querySelector(".ait-panel") ? "Please provide input via the DevTools panel." : "Is @ait-co/devtools/panel imported?";
-			reject(/* @__PURE__ */ new Error(`[@ait-co/devtools] Prompt timeout for "${type}" after ${PROMPT_TIMEOUT_MS / 1e3}s. ${hint}`));
-		}, PROMPT_TIMEOUT_MS);
-		const handler = (e) => {
-			cleanup();
-			resolve(e.detail);
-		};
-		const cancelHandler = () => {
-			cleanup();
-			reject(/* @__PURE__ */ new Error(`[@ait-co/devtools] Prompt cancelled for "${type}"`));
-		};
-		window.addEventListener(eventName, handler);
-		window.addEventListener(cancelName, cancelHandler);
-		window.dispatchEvent(new CustomEvent("__ait:prompt-request", { detail: { type } }));
-	});
-}
-//#endregion
-//#region src/mock/permissions.ts
-/**
-* 권한 시스템 mock
-* 각 디바이스 API (.getPermission, .openPermissionDialog)에 부착된다.
-*/
-/**
-* web-framework 3.0+ 권한 에러 기반 클래스.
-* `instanceof PermissionError`로 체크하는 코드와 호환된다.
-*/
-var PermissionError = class extends Error {
-	constructor({ methodName, message }) {
-		super(message ?? `${methodName}: permission denied`);
-		this.name = `${methodName}PermissionError`;
-	}
-};
-/** openCamera 권한 에러 */
-var OpenCameraPermissionError = class extends PermissionError {
-	constructor() {
-		super({ methodName: "openCamera" });
-	}
-};
-/** fetchAlbumPhotos 권한 에러 */
-var FetchAlbumPhotosPermissionError = class extends PermissionError {
-	constructor() {
-		super({ methodName: "fetchAlbumPhotos" });
-	}
-};
-/** fetchContacts 권한 에러 */
-var FetchContactsPermissionError = class extends PermissionError {
-	constructor() {
-		super({ methodName: "fetchContacts" });
-	}
-};
-/** getCurrentLocation 권한 에러 */
-var GetCurrentLocationPermissionError = class extends PermissionError {
-	constructor() {
-		super({ methodName: "getCurrentLocation" });
-	}
-};
-/** getClipboardText 권한 에러 */
-var GetClipboardTextPermissionError = class extends PermissionError {
-	constructor() {
-		super({ methodName: "getClipboardText" });
-	}
-};
-/** setClipboardText 권한 에러 */
-var SetClipboardTextPermissionError = class extends PermissionError {
-	constructor() {
-		super({ methodName: "setClipboardText" });
-	}
-};
 /**
-* startUpdateLocation 권한 에러.
-* web-framework 3.0에서 GetCurrentLocationPermissionError의 alias.
+* HapticFeedbackType 10종 → navigator.vibrate 패턴 매핑.
+* 숫자: 진동 ms. 배열: [진동, 정지, 진동, …] 교대 패턴.
 */
-const StartUpdateLocationPermissionError = GetCurrentLocationPermissionError;
-const permissionErrorMap = {
-	openCamera: OpenCameraPermissionError,
-	fetchAlbumPhotos: FetchAlbumPhotosPermissionError,
-	fetchAlbumItems: FetchAlbumPhotosPermissionError,
-	fetchContacts: FetchContactsPermissionError,
-	getCurrentLocation: GetCurrentLocationPermissionError,
-	getClipboardText: GetClipboardTextPermissionError,
-	setClipboardText: SetClipboardTextPermissionError
+const HAPTIC_VIBRATE_PATTERN = {
+	tickWeak: 10,
+	tap: 20,
+	tickMedium: 30,
+	softMedium: 40,
+	basicWeak: 15,
+	basicMedium: 50,
+	success: [
+		10,
+		40,
+		10
+	],
+	error: [
+		40,
+		30,
+		40
+	],
+	wiggle: [
+		20,
+		20,
+		20,
+		20,
+		20
+	],
+	confetti: [
+		10,
+		20,
+		10,
+		20,
+		10,
+		20,
+		10
+	]
 };
-async function getPermission(name) {
-	return aitState.state.permissions[name];
-}
-async function openPermissionDialog(name) {
-	if (aitState.state.permissions[name] === "allowed") return "allowed";
-	aitState.patch("permissions", { [name]: "allowed" });
-	return "allowed";
-}
-async function requestPermission(permission) {
-	return openPermissionDialog(permission.name);
-}
-/** 권한이 필요한 함수에 .getPermission(), .openPermissionDialog()를 부착 */
-function withPermission(fn, permissionName) {
-	const enhanced = fn;
-	enhanced.getPermission = () => getPermission(permissionName);
-	enhanced.openPermissionDialog = () => openPermissionDialog(permissionName);
-	return enhanced;
+async function generateHapticFeedback(options) {
+	const timestamp = Date.now();
+	aitState.logAnalytics({
+		type: "haptic",
+		params: { hapticType: options.type }
+	});
+	const pattern = HAPTIC_VIBRATE_PATTERN[options.type] ?? 30;
+	const vibrated = typeof navigator.vibrate === "function" ? navigator.vibrate(pattern) : false;
+	aitState.logSdkCall({
+		method: "generateHapticFeedback",
+		args: [{ type: options.type }],
+		timestamp,
+		status: "resolved",
+		result: {
+			hapticType: options.type,
+			vibrated
+		},
+		fidelity: "partial"
+	});
 }
-/**
-* 권한 체크 후 denied면 per-API *PermissionError 서브클래스를 throw한다.
-* 실 3.0 SDK 동작과 일치 — `instanceof PermissionError` 분기가 mock에서도 동작한다 (#372).
-*/
-function checkPermission(name, fnName) {
-	if (aitState.state.permissions[name] === "denied") {
-		const ErrorClass = permissionErrorMap[fnName];
-		if (ErrorClass) throw new ErrorClass();
-		throw new PermissionError({ methodName: fnName });
-	}
+async function saveBase64Data(params) {
+	const a = document.createElement("a");
+	a.href = `data:${params.mimeType};base64,${params.data}`;
+	a.download = params.fileName;
+	a.click();
 }
 //#endregion
-//#region src/mock/device/camera.ts
+//#region src/mock/device/location.ts
 /**
-* Camera & Album Photos & Album Items mock
+* Location mock (getCurrentLocation, startUpdateLocation)
 * mock/web/prompt 모드 지원
 */
-async function openCameraMock() {
-	const images = getMockImages();
+var Accuracy = /* @__PURE__ */ function(Accuracy) {
+	Accuracy[Accuracy["Lowest"] = 1] = "Lowest";
+	Accuracy[Accuracy["Low"] = 2] = "Low";
+	Accuracy[Accuracy["Balanced"] = 3] = "Balanced";
+	Accuracy[Accuracy["High"] = 4] = "High";
+	Accuracy[Accuracy["Highest"] = 5] = "Highest";
+	Accuracy[Accuracy["BestForNavigation"] = 6] = "BestForNavigation";
+	return Accuracy;
+}(Accuracy || {});
+function buildLocation() {
 	return {
-		id: crypto.randomUUID(),
-		dataUri: images[0]
+		coords: { ...aitState.state.location.coords },
+		timestamp: Date.now(),
+		accessLocation: aitState.state.location.accessLocation
 	};
 }
-async function openCameraWeb() {
-	return new Promise((resolve, reject) => {
-		const input = document.createElement("input");
-		input.type = "file";
-		input.accept = "image/*";
-		input.capture = "environment";
-		let settled = false;
-		input.onchange = () => {
-			settled = true;
-			const file = input.files?.[0];
-			if (!file) {
-				reject(/* @__PURE__ */ new Error("No file selected"));
-				return;
-			}
-			const reader = new FileReader();
-			reader.onload = () => resolve({
-				id: crypto.randomUUID(),
-				dataUri: reader.result
-			});
-			reader.onerror = () => reject(/* @__PURE__ */ new Error("Failed to read file"));
-			reader.readAsDataURL(file);
-		};
-		const onFocus = () => {
-			setTimeout(() => {
-				if (!settled) reject(/* @__PURE__ */ new Error("File picker cancelled"));
-				window.removeEventListener("focus", onFocus);
-			}, 300);
-		};
-		window.addEventListener("focus", onFocus);
-		input.click();
-	});
+async function getCurrentLocationMock() {
+	return buildLocation();
 }
-async function openCameraPrompt() {
-	const dataUri = await waitForPromptResponse("camera");
-	return {
-		id: crypto.randomUUID(),
-		dataUri
-	};
-}
-const _openCamera = async (_options) => {
-	checkPermission("camera", "openCamera");
-	const mode = aitState.state.deviceModes.camera;
-	if (mode === "web") return openCameraWeb();
-	if (mode === "prompt") return openCameraPrompt();
-	return openCameraMock();
-};
-const openCamera = withPermission(_openCamera, "camera");
-async function fetchAlbumPhotosMock(maxCount) {
-	return getMockImages().slice(0, maxCount).map((dataUri) => ({
-		id: crypto.randomUUID(),
-		dataUri
-	}));
-}
-async function fetchAlbumPhotosWeb(maxCount) {
-	return new Promise((resolve, reject) => {
-		const input = document.createElement("input");
-		input.type = "file";
-		input.accept = "image/*";
-		input.multiple = true;
-		let settled = false;
-		input.onchange = async () => {
-			settled = true;
-			const files = Array.from(input.files ?? []).slice(0, maxCount);
-			if (files.length === 0) {
-				reject(/* @__PURE__ */ new Error("No files selected"));
-				return;
-			}
-			resolve(await Promise.all(files.map((file) => new Promise((res, rej) => {
-				const reader = new FileReader();
-				reader.onload = () => res({
-					id: crypto.randomUUID(),
-					dataUri: reader.result
-				});
-				reader.onerror = () => rej(/* @__PURE__ */ new Error("Failed to read file"));
-				reader.readAsDataURL(file);
-			}))));
-		};
-		const onFocus = () => {
-			setTimeout(() => {
-				if (!settled) reject(/* @__PURE__ */ new Error("File picker cancelled"));
-				window.removeEventListener("focus", onFocus);
-			}, 300);
-		};
-		window.addEventListener("focus", onFocus);
-		input.click();
+async function getCurrentLocationWeb() {
+	return new Promise((resolve) => {
+		if (!navigator.geolocation) {
+			console.warn("[@ait-co/devtools] Geolocation API not available, falling back to mock");
+			resolve(buildLocation());
+			return;
+		}
+		navigator.geolocation.getCurrentPosition((pos) => {
+			resolve({
+				coords: {
+					latitude: pos.coords.latitude,
+					longitude: pos.coords.longitude,
+					altitude: pos.coords.altitude ?? 0,
+					accuracy: pos.coords.accuracy,
+					altitudeAccuracy: pos.coords.altitudeAccuracy ?? 0,
+					heading: pos.coords.heading ?? 0
+				},
+				timestamp: pos.timestamp,
+				accessLocation: "FINE"
+			});
+		}, () => {
+			console.warn("[@ait-co/devtools] Geolocation failed, falling back to mock");
+			resolve(buildLocation());
+		});
 	});
 }
-async function fetchAlbumPhotosPrompt(maxCount) {
-	return (await waitForPromptResponse("photos")).slice(0, maxCount).map((dataUri) => ({
-		id: crypto.randomUUID(),
-		dataUri
-	}));
+async function getCurrentLocationPrompt() {
+	return waitForPromptResponse("location");
 }
-const _fetchAlbumPhotos = async (options) => {
-	checkPermission("photos", "fetchAlbumPhotos");
-	const maxCount = options?.maxCount ?? 10;
-	const mode = aitState.state.deviceModes.photos;
-	if (mode === "web") return fetchAlbumPhotosWeb(maxCount);
-	if (mode === "prompt") return fetchAlbumPhotosPrompt(maxCount);
-	return fetchAlbumPhotosMock(maxCount);
+const _getCurrentLocation = async (_options) => {
+	checkPermission("geolocation", "getCurrentLocation");
+	const mode = aitState.state.deviceModes.location;
+	if (mode === "web") return getCurrentLocationWeb();
+	if (mode === "prompt") return getCurrentLocationPrompt();
+	return getCurrentLocationMock();
 };
-const fetchAlbumPhotos = withPermission(_fetchAlbumPhotos, "photos");
-async function fetchAlbumItemsMock(maxCount, types) {
-	return getMockImages().slice(0, maxCount).filter(() => types.includes("PHOTO")).map((dataUri) => ({
-		id: crypto.randomUUID(),
-		dataUri,
-		type: "PHOTO"
-	}));
+const getCurrentLocation = withPermission(_getCurrentLocation, "geolocation");
+function startUpdateLocationMock(eventParams) {
+	const { onEvent, options } = eventParams;
+	const interval = Math.max(options.timeInterval, 500);
+	const id = setInterval(() => {
+		const loc = buildLocation();
+		loc.coords.latitude += (Math.random() - .5) * 1e-4;
+		loc.coords.longitude += (Math.random() - .5) * 1e-4;
+		onEvent(loc);
+	}, interval);
+	return () => clearInterval(id);
 }
-async function fetchAlbumItemsWeb(maxCount, types) {
-	return new Promise((resolve) => {
-		const input = document.createElement("input");
-		input.type = "file";
-		input.accept = types.includes("VIDEO") ? "image/*,video/*" : "image/*";
-		input.multiple = true;
-		let settled = false;
-		input.onchange = async () => {
-			settled = true;
-			const files = Array.from(input.files ?? []).slice(0, maxCount);
-			if (files.length === 0) {
-				resolve([]);
-				return;
-			}
-			resolve(await Promise.all(files.map((file) => new Promise((res, rej) => {
-				const itemType = file.type.startsWith("video/") ? "VIDEO" : "PHOTO";
-				const reader = new FileReader();
-				reader.onload = () => res({
-					id: crypto.randomUUID(),
-					dataUri: reader.result,
-					type: itemType
-				});
-				reader.onerror = () => rej(/* @__PURE__ */ new Error("Failed to read file"));
-				reader.readAsDataURL(file);
-			}))));
-		};
-		const onFocus = () => {
-			setTimeout(() => {
-				if (!settled) resolve([]);
-				window.removeEventListener("focus", onFocus);
-			}, 300);
-		};
-		window.addEventListener("focus", onFocus);
-		input.click();
-	});
+function startUpdateLocationWeb(eventParams) {
+	const { onEvent, onError } = eventParams;
+	if (!navigator.geolocation) {
+		console.warn("[@ait-co/devtools] Geolocation API not available, falling back to mock");
+		return startUpdateLocationMock(eventParams);
+	}
+	const watchId = navigator.geolocation.watchPosition((pos) => {
+		onEvent({
+			coords: {
+				latitude: pos.coords.latitude,
+				longitude: pos.coords.longitude,
+				altitude: pos.coords.altitude ?? 0,
+				accuracy: pos.coords.accuracy,
+				altitudeAccuracy: pos.coords.altitudeAccuracy ?? 0,
+				heading: pos.coords.heading ?? 0
+			},
+			timestamp: pos.timestamp,
+			accessLocation: "FINE"
+		});
+	}, (err) => onError(err));
+	return () => navigator.geolocation.clearWatch(watchId);
 }
-async function fetchAlbumItemsPrompt(maxCount) {
-	return (await waitForPromptResponse("photos")).slice(0, maxCount).map((dataUri) => ({
-		id: crypto.randomUUID(),
-		dataUri,
-		type: "PHOTO"
-	}));
+function startUpdateLocationPrompt(eventParams) {
+	const { onEvent } = eventParams;
+	const handler = (e) => {
+		onEvent(e.detail);
+	};
+	window.addEventListener("__ait:prompt-response:location-update", handler);
+	window.dispatchEvent(new CustomEvent("__ait:prompt-request", { detail: { type: "location-update" } }));
+	return () => window.removeEventListener("__ait:prompt-response:location-update", handler);
 }
-const _fetchAlbumItems = async (options) => {
-	checkPermission("photos", "fetchAlbumItems");
-	const maxCount = options?.maxCount ?? 10;
-	const types = options?.types ?? ["PHOTO"];
-	const mode = aitState.state.deviceModes.photos;
-	if (mode === "web") return fetchAlbumItemsWeb(maxCount, types);
-	if (mode === "prompt") return fetchAlbumItemsPrompt(maxCount);
-	return fetchAlbumItemsMock(maxCount, types);
+const _startUpdateLocation = (eventParams) => {
+	const mode = aitState.state.deviceModes.location;
+	if (mode === "web") return startUpdateLocationWeb(eventParams);
+	if (mode === "prompt") return startUpdateLocationPrompt(eventParams);
+	return startUpdateLocationMock(eventParams);
 };
-const fetchAlbumItems = withPermission(_fetchAlbumItems, "photos");
+const startUpdateLocation = withPermission(_startUpdateLocation, "geolocation");
 //#endregion
-//#region src/mock/device/clipboard.ts
+//#region src/mock/device/network.ts
 /**
-* Clipboard mock
-* mock/web 모드 지원
+* Network Status mock (mode-aware helper)
+* navigation 모듈에서 사용. circular dep 방지를 위해 device에 위치.
 */
-const _getClipboardText = async () => {
-	checkPermission("clipboard", "getClipboardText");
-	if (aitState.state.deviceModes.clipboard === "mock") return aitState.state.mockData.clipboardText;
-	try {
-		return await navigator.clipboard.readText();
-	} catch {
-		return "";
-	}
-};
-const getClipboardText = withPermission(_getClipboardText, "clipboard");
-const _setClipboardText = async (text) => {
-	checkPermission("clipboard", "setClipboardText");
-	if (aitState.state.deviceModes.clipboard === "mock") {
-		aitState.patch("mockData", { clipboardText: text });
-		return;
-	}
-	await navigator.clipboard.writeText(text);
-};
-const setClipboardText = withPermission(_setClipboardText, "clipboard");
-//#endregion
-//#region src/mock/device/contacts.ts
 /**
-* Contacts mock
+* Web mode: uses navigator.connection.effectiveType (4g/3g/2g) and navigator.onLine.
+* Limitations: WIFI, 5G, WWAN cannot be detected via the Network Information API.
+* Falls back to state-based value when effectiveType is unavailable.
 */
-const _fetchContacts = async (options) => {
-	checkPermission("contacts", "fetchContacts");
-	let contacts = aitState.state.contacts;
-	if (options.query?.contains) {
-		const q = options.query.contains.toLowerCase();
-		contacts = contacts.filter((c) => c.name.toLowerCase().includes(q) || c.phoneNumber.includes(q));
+function getNetworkStatusByMode() {
+	const mode = aitState.state.deviceModes.network;
+	if (mode === "mock") return null;
+	if (mode === "web") {
+		if (!navigator.onLine) return "OFFLINE";
+		const conn = navigator.connection;
+		if (conn?.effectiveType) return {
+			"4g": "4G",
+			"3g": "3G",
+			"2g": "2G",
+			"slow-2g": "2G"
+		}[conn.effectiveType] ?? "UNKNOWN";
+		return aitState.state.networkStatus;
 	}
-	const sliced = contacts.slice(options.offset, options.offset + options.size);
-	const nextOffset = options.offset + options.size;
-	return {
-		result: sliced,
-		nextOffset: nextOffset < contacts.length ? nextOffset : null,
-		done: nextOffset >= contacts.length
-	};
-};
-const fetchContacts = withPermission(_fetchContacts, "contacts");
+	return null;
+}
 //#endregion
-//#region src/mock/device/haptic.ts
+//#region src/mock/device/pdf.ts
 /**
-* Haptic Feedback & saveBase64Data mock
+* Base64로 인코딩된 PDF 데이터를 네이티브 PDF 뷰어로 여는 mock.
+* mock 환경에서는 즉시 `'CLOSE'`를 반환한다.
+*/
+async function openPDFViewer(_params) {
+	await Promise.resolve();
+	return "CLOSE";
+}
+//#endregion
+//#region src/mock/proxy.ts
+/**
+* 미구현 API용 Proxy 트립와이어.
 *
-* generateHapticFeedback — 영역 3 (하드웨어 API 관측):
-*   - 10종 HapticFeedbackType을 navigator.vibrate 패턴으로 매핑(근사, best-effort).
-*   - `typeof navigator.vibrate === 'function'` 가드 — API 없는 환경에서 throw 없이 skip.
-*   - sdkCallLog에 🟡(partial)로 기록. params: { hapticType, vibrated: boolean }.
-*   - 시그니처 불변 — __typecheck.ts의 Assert<Mock, Original> 통과.
+* 미구현 프로퍼티에 접근하면 throw한다. 이는 "devtools에서는 멀쩡히 돌지만
+* 실 SDK에선 실제로 동작하는" 시나리오를 차단하기 위한 의도적 선택이다.
+* mock이 미구현인 API는 실 SDK에서는 존재할 수 있고, 사용자가 이를 인지하지
+* 못한 채 개발을 이어가면 배포 시점에 놀라게 된다. 에러 메시지에 이슈 URL을
+* 포함해 사용자가 mock 누락을 제보할 수 있게 한다.
+*
+* ## KNOWN_UNIMPLEMENTED 정책
+* SDK에 존재하는 것으로 알려져 있으나 현재 mock이 없는 API 이름만 이 집합에 둔다.
+* 이 경우에만 throw 대신 🔴 inert no-op을 반환하고 sdkCallLog에 기록한다.
+* 완전히 미지의 이름은 여전히 throw — "잘 되는 척" 방지.
 */
+const ISSUES_URL = "https://github.com/apps-in-toss-community/devtools/issues";
 /**
-* HapticFeedbackType 10종 → navigator.vibrate 패턴 매핑.
-* 숫자: 진동 ms. 배열: [진동, 정지, 진동, …] 교대 패턴.
+* SDK에 존재하나 mock이 아직 없는 것으로 확인된 이름 목록.
+* 새 API가 SDK에 추가되면 여기에 추가하고 별도 PR에서 mock 구현으로 이동한다.
+* 확인되지 않은 이름은 절대 여기에 추가하지 않는다 — throw가 더 안전하다.
 */
-const HAPTIC_VIBRATE_PATTERN = {
-	tickWeak: 10,
-	tap: 20,
-	tickMedium: 30,
-	softMedium: 40,
-	basicWeak: 15,
-	basicMedium: 50,
-	success: [
-		10,
-		40,
-		10
-	],
-	error: [
-		40,
-		30,
-		40
-	],
-	wiggle: [
-		20,
-		20,
-		20,
-		20,
-		20
-	],
-	confetti: [
-		10,
-		20,
-		10,
-		20,
-		10,
-		20,
-		10
-	]
-};
-async function generateHapticFeedback(options) {
-	const timestamp = Date.now();
-	aitState.logAnalytics({
-		type: "haptic",
-		params: { hapticType: options.type }
-	});
-	const pattern = HAPTIC_VIBRATE_PATTERN[options.type] ?? 30;
-	const vibrated = typeof navigator.vibrate === "function" ? navigator.vibrate(pattern) : false;
-	aitState.logSdkCall({
-		method: "generateHapticFeedback",
-		args: [{ type: options.type }],
-		timestamp,
-		status: "resolved",
-		result: {
-			hapticType: options.type,
-			vibrated
-		},
-		fidelity: "partial"
-	});
-}
-async function saveBase64Data(params) {
-	const a = document.createElement("a");
-	a.href = `data:${params.mimeType};base64,${params.data}`;
-	a.download = params.fileName;
-	a.click();
+const KNOWN_UNIMPLEMENTED = /* @__PURE__ */ new Set([]);
+function createMockProxy(moduleName, implementations) {
+	return new Proxy(implementations, { get(target, prop) {
+		if (typeof prop === "symbol") return void 0;
+		if (prop in target) return target[prop];
+		const name = String(prop);
+		if (KNOWN_UNIMPLEMENTED.has(name)) return (...args) => {
+			console.warn(`[@ait-co/devtools] ${moduleName}.${name} is known-unimplemented (🔴 inert). Returning undefined. Please file or upvote an issue: ${ISSUES_URL}`);
+			aitState.logSdkCall({
+				method: `${moduleName}.${name}`,
+				args,
+				timestamp: Date.now(),
+				status: "resolved",
+				result: void 0,
+				fidelity: "inert"
+			});
+		};
+		throw new Error(`[@ait-co/devtools] ${moduleName}.${prop} is not mocked. This API may exist in @apps-in-toss/web-framework, but devtools' mock does not cover it yet. Please file an issue: ${ISSUES_URL}`);
+	} });
 }
 //#endregion
-//#region src/mock/device/location.ts
+//#region src/mock/device/storage.ts
 /**
-* Location mock (getCurrentLocation, startUpdateLocation)
-* mock/web/prompt 모드 지원
+* Storage mock
+* localStorage에 `__ait_storage:` prefix로 저장하여 앱 자체 localStorage와 분리
 */
-var Accuracy = /* @__PURE__ */ function(Accuracy) {
-	Accuracy[Accuracy["Lowest"] = 1] = "Lowest";
-	Accuracy[Accuracy["Low"] = 2] = "Low";
-	Accuracy[Accuracy["Balanced"] = 3] = "Balanced";
-	Accuracy[Accuracy["High"] = 4] = "High";
-	Accuracy[Accuracy["Highest"] = 5] = "Highest";
-	Accuracy[Accuracy["BestForNavigation"] = 6] = "BestForNavigation";
-	return Accuracy;
-}(Accuracy || {});
-function buildLocation() {
-	return {
-		coords: { ...aitState.state.location.coords },
-		timestamp: Date.now(),
-		accessLocation: aitState.state.location.accessLocation
+const Storage = createMockProxy("Storage", {
+	getItem: async (key) => {
+		return localStorage.getItem(`__ait_storage:${key}`);
+	},
+	setItem: async (key, value) => {
+		localStorage.setItem(`__ait_storage:${key}`, value);
+	},
+	removeItem: async (key) => {
+		localStorage.removeItem(`__ait_storage:${key}`);
+	},
+	clearItems: async () => {
+		const keys = Object.keys(localStorage).filter((k) => k.startsWith("__ait_storage:"));
+		for (const k of keys) localStorage.removeItem(k);
+	}
+});
+//#endregion
+//#region src/mock/observe.ts
+/**
+* fn을 observe로 감싼다.
+*
+* @param apiName  - 로그에 기록할 SDK 메서드 이름 (예: `'setScreenAwakeMode'`)
+* @param fidelity - 이 mock의 fidelity grade ('faithful' | 'partial' | 'inert')
+* @param fn       - 실제 mock 구현체. 시그니처를 그대로 통과시킨다.
+* @returns fn과 동일한 타입의 래퍼 함수
+*/
+function observe(apiName, fidelity, fn) {
+	return (...args) => {
+		const timestamp = Date.now();
+		const safeArgs = args.map((a) => safeSerialize(a));
+		const result = fn(...args);
+		if (result instanceof Promise) {
+			aitState.logSdkCall({
+				method: apiName,
+				args: safeArgs,
+				timestamp,
+				status: "pending",
+				fidelity
+			});
+			result.then((value) => {
+				aitState.logSdkCall({
+					method: apiName,
+					args: safeArgs,
+					timestamp,
+					status: "resolved",
+					result: safeSerialize(value),
+					fidelity
+				});
+			}, (err) => {
+				aitState.logSdkCall({
+					method: apiName,
+					args: safeArgs,
+					timestamp,
+					status: "rejected",
+					error: err instanceof Error ? err.message : String(err),
+					fidelity
+				});
+			});
+			return result;
+		}
+		aitState.logSdkCall({
+			method: apiName,
+			args: safeArgs,
+			timestamp,
+			status: "resolved",
+			result: safeSerialize(result),
+			fidelity
+		});
+		return result;
 	};
 }
-async function getCurrentLocationMock() {
-	return buildLocation();
+/**
+* 값을 JSON-safe한 형태로 변환한다.
+* - null / primitive — 그대로.
+* - 함수 — `'[Function: name]'` 문자열.
+* - 기타 객체 — JSON.stringify 실패 시 `'[unserializable]'`.
+*/
+function safeSerialize(value) {
+	if (value === null || value === void 0) return value;
+	if (typeof value === "function") return `[Function: ${value.name || "anonymous"}]`;
+	if (typeof value !== "object") return value;
+	try {
+		return JSON.parse(JSON.stringify(value));
+	} catch {
+		return "[unserializable]";
+	}
 }
-async function getCurrentLocationWeb() {
-	return new Promise((resolve) => {
-		if (!navigator.geolocation) {
-			console.warn("[@ait-co/devtools] Geolocation API not available, falling back to mock");
-			resolve(buildLocation());
-			return;
-		}
-		navigator.geolocation.getCurrentPosition((pos) => {
-			resolve({
-				coords: {
-					latitude: pos.coords.latitude,
-					longitude: pos.coords.longitude,
-					altitude: pos.coords.altitude ?? 0,
-					accuracy: pos.coords.accuracy,
-					altitudeAccuracy: pos.coords.altitudeAccuracy ?? 0,
-					heading: pos.coords.heading ?? 0
-				},
-				timestamp: pos.timestamp,
-				accessLocation: "FINE"
-			});
-		}, () => {
-			console.warn("[@ait-co/devtools] Geolocation failed, falling back to mock");
-			resolve(buildLocation());
-		});
-	});
+//#endregion
+//#region src/mock/navigation/index.ts
+/**
+* 화면/네비게이션/이벤트 mock
+*/
+async function closeView() {
+	console.log("[@ait-co/devtools] closeView called");
+	window.history.back();
 }
-async function getCurrentLocationPrompt() {
-	return waitForPromptResponse("location");
+async function openURL(url) {
+	console.log("[@ait-co/devtools] openURL:", url);
+	window.open(url, "_blank");
 }
-const _getCurrentLocation = async (_options) => {
-	checkPermission("geolocation", "getCurrentLocation");
-	const mode = aitState.state.deviceModes.location;
-	if (mode === "web") return getCurrentLocationWeb();
-	if (mode === "prompt") return getCurrentLocationPrompt();
-	return getCurrentLocationMock();
-};
-const getCurrentLocation = withPermission(_getCurrentLocation, "geolocation");
-function startUpdateLocationMock(eventParams) {
-	const { onEvent, options } = eventParams;
-	const interval = Math.max(options.timeInterval, 500);
-	const id = setInterval(() => {
-		const loc = buildLocation();
-		loc.coords.latitude += (Math.random() - .5) * 1e-4;
-		loc.coords.longitude += (Math.random() - .5) * 1e-4;
-		onEvent(loc);
-	}, interval);
-	return () => clearInterval(id);
+async function share(message) {
+	if (navigator.share) {
+		await navigator.share({ text: message.message });
+		return;
+	}
+	console.log("[@ait-co/devtools] share:", message.message);
 }
-function startUpdateLocationWeb(eventParams) {
-	const { onEvent, onError } = eventParams;
-	if (!navigator.geolocation) {
-		console.warn("[@ait-co/devtools] Geolocation API not available, falling back to mock");
-		return startUpdateLocationMock(eventParams);
+async function getTossShareLink(path, _ogImageUrl) {
+	return `https://toss.im/share/mock${path}`;
+}
+async function setIosSwipeGestureEnabled(options) {
+	console.log("[@ait-co/devtools] setIosSwipeGestureEnabled:", options.isEnabled);
+	aitState.patch("navigation", { iosSwipeGestureEnabled: options.isEnabled });
+}
+async function setDeviceOrientation(options) {
+	const current = aitState.state.viewport.orientation;
+	if (current === "auto") {
+		console.log("[@ait-co/devtools] setDeviceOrientation:", options.type);
+		aitState.patch("viewport", { appOrientation: options.type });
+		return;
 	}
-	const watchId = navigator.geolocation.watchPosition((pos) => {
-		onEvent({
-			coords: {
-				latitude: pos.coords.latitude,
-				longitude: pos.coords.longitude,
-				altitude: pos.coords.altitude ?? 0,
-				accuracy: pos.coords.accuracy,
-				altitudeAccuracy: pos.coords.altitudeAccuracy ?? 0,
-				heading: pos.coords.heading ?? 0
-			},
-			timestamp: pos.timestamp,
-			accessLocation: "FINE"
-		});
-	}, (err) => onError(err));
-	return () => navigator.geolocation.clearWatch(watchId);
+	console.warn(`[@ait-co/devtools] setDeviceOrientation(${options.type}) ignored — Panel is forcing "${current}". Change the Viewport tab's orientation to "auto" to let the app control rotation.`);
 }
-function startUpdateLocationPrompt(eventParams) {
-	const { onEvent } = eventParams;
+const setScreenAwakeMode = observe("setScreenAwakeMode", "inert", async (options) => {
+	console.log("[@ait-co/devtools] setScreenAwakeMode:", options.enabled);
+	return { enabled: options.enabled };
+});
+const setSecureScreen = observe("setSecureScreen", "inert", async (options) => {
+	console.log("[@ait-co/devtools] setSecureScreen:", options.enabled);
+	return { enabled: options.enabled };
+});
+const requestReview = observe("requestReview", "inert", async () => {
+	console.log("[@ait-co/devtools] requestReview called");
+});
+requestReview.isSupported = () => true;
+function getPlatformOS() {
+	return aitState.state.platform;
+}
+function getOperationalEnvironment() {
+	return aitState.state.environment;
+}
+function getTossAppVersion() {
+	return aitState.state.appVersion;
+}
+function isMinVersionSupported(minVersions) {
+	const required = aitState.state.platform === "ios" ? minVersions.ios : minVersions.android;
+	if (required === "always") return true;
+	if (required === "never") return false;
+	const current = aitState.state.appVersion.split(".").map(Number);
+	const min = required.split(".").map(Number);
+	for (let i = 0; i < 3; i++) {
+		if ((current[i] ?? 0) > (min[i] ?? 0)) return true;
+		if ((current[i] ?? 0) < (min[i] ?? 0)) return false;
+	}
+	return true;
+}
+function getSchemeUri() {
+	return aitState.state.schemeUri || window.location.pathname;
+}
+function getLocale() {
+	return aitState.state.locale;
+}
+function getDeviceId() {
+	return aitState.state.deviceId;
+}
+function getGroupId() {
+	return aitState.state.groupId;
+}
+async function getNetworkStatus() {
+	const modeResult = getNetworkStatusByMode();
+	if (modeResult) return modeResult;
+	return aitState.state.networkStatus;
+}
+async function getServerTime() {
+	return Date.now();
+}
+getServerTime.isSupported = () => true;
+/**
+* 현재 backEvent 구독자 수. graniteEvent.addEventListener('backEvent', …)가
+* 증가시키고, 반환된 cleanup이 감소시킨다. 호스트 back 메시지 처리 시 인터셉트
+* 여부를 판단하는 데 쓰인다.
+*
+* @internal 테스트 및 safe-area-bridge에서만 사용.
+*/
+let _backEventSubscriberCount = 0;
+const graniteEvent = { addEventListener(event, { onEvent, onError }) {
+	const handler = () => {
+		try {
+			onEvent();
+		} catch (e) {
+			onError?.(e instanceof Error ? e : new Error(String(e)));
+		}
+	};
+	window.addEventListener(`__ait:${event}`, handler);
+	if (event === "backEvent") _backEventSubscriberCount++;
+	let cleaned = false;
+	return () => {
+		if (cleaned) return;
+		cleaned = true;
+		window.removeEventListener(`__ait:${event}`, handler);
+		if (event === "backEvent") _backEventSubscriberCount--;
+	};
+} };
+/**
+* 호스트 back 내비게이션을 처리한다.
+*
+* backEvent 구독자가 1명 이상이면 `window.dispatchEvent(new CustomEvent('__ait:backEvent'))`만
+* 발사한다 — 미니앱이 back을 가로채는(intercept) 채널이고 실제 토스 호스트와 동일한 시맨틱.
+* 구독자가 없으면 `history.back()`을 호출해 기본 브라우저 뒤로가기를 수행한다.
+*
+* env 1 패널의 back 버튼(`src/panel/viewport.ts` `aitState.trigger('backEvent')`)과
+* 동일한 경로를 거쳐 back 시맨틱의 단일 소유처를 navigation 모듈에 유지한다.
+*/
+function dispatchHostBackNavigation() {
+	if (_backEventSubscriberCount > 0) window.dispatchEvent(new CustomEvent("__ait:backEvent"));
+	else history.back();
+}
+const appsInTossEvent = { addEventListener(_event, _handlers) {
+	return () => {};
+} };
+const tdsEvent = { addEventListener(event, { onEvent }) {
 	const handler = (e) => {
-		onEvent(e.detail);
+		const detail = e.detail;
+		onEvent(detail);
 	};
-	window.addEventListener("__ait:prompt-response:location-update", handler);
-	window.dispatchEvent(new CustomEvent("__ait:prompt-request", { detail: { type: "location-update" } }));
-	return () => window.removeEventListener("__ait:prompt-response:location-update", handler);
+	window.addEventListener(`__ait:${event}`, handler);
+	return () => window.removeEventListener(`__ait:${event}`, handler);
+} };
+/**
+* @deprecated web-framework 3.0 에서 제거됨. 2.x 소비자 back-compat용으로 유지.
+*/
+function onVisibilityChangedByTransparentServiceWeb(eventParams) {
+	const handler = () => eventParams.onEvent(!document.hidden);
+	document.addEventListener("visibilitychange", handler);
+	return () => document.removeEventListener("visibilitychange", handler);
 }
-const _startUpdateLocation = (eventParams) => {
-	const mode = aitState.state.deviceModes.location;
-	if (mode === "web") return startUpdateLocationWeb(eventParams);
-	if (mode === "prompt") return startUpdateLocationPrompt(eventParams);
-	return startUpdateLocationMock(eventParams);
+const env = { getDeploymentId: () => aitState.state.deploymentId };
+function getAppsInTossGlobals() {
+	return {
+		deploymentId: aitState.state.deploymentId,
+		brandDisplayName: aitState.state.brand.displayName,
+		brandIcon: aitState.state.brand.icon,
+		brandPrimaryColor: aitState.state.brand.primaryColor
+	};
+}
+const SafeAreaInsets = {
+	get: () => ({ ...aitState.state.safeAreaInsets }),
+	subscribe: ({ onEvent }) => {
+		return aitState.subscribe(() => onEvent({ ...aitState.state.safeAreaInsets }));
+	}
 };
-const startUpdateLocation = withPermission(_startUpdateLocation, "geolocation");
+/** @deprecated */
+function getSafeAreaInsets() {
+	return aitState.state.safeAreaInsets.top;
+}
+//#endregion
+//#region src/mock/safe-area-bridge.ts
+/**
+* env-2 postMessage bridges (#484, #510).
+*
+* In the AITC Sandbox PWA (env 2) the dev app runs inside the launcher's
+* full-viewport `<iframe>`. The launcher is the top-level document, so its
+* `env(safe-area-inset-*)` measurement is the ground truth for the real device
+* geometry. The framed page's mock would otherwise report a synthetic preset
+* value (e.g. top=54), which sdk-example then double-pads on top of a viewport
+* that already starts below the status bar — the env-2 "dead band" defect.
+*
+* This module installs receive-half listeners for two message types:
+*
+* 1. `ait:safe-area-insets` (#484): the launcher forwards its real env() insets
+*    to the framed page on iframe load and resize/orientationchange. Validates the
+*    envelope and writes real insets into the mock SafeAreaInsets state, firing the
+*    subscribe path (see navigation/index.ts) so apps that subscribe re-read the
+*    corrected values.
+*
+* 2. `ait:navigate-back` (#510): the launcher partner bar's `←` button posts this
+*    command to the framed page. The receive half calls `dispatchHostBackNavigation()`
+*    (navigation/index.ts): if backEvent subscribers are present, a `__ait:backEvent`
+*    CustomEvent is dispatched (the mini-app intercept channel, matching the env-1
+*    panel path); otherwise `history.back()` is called. No data other than `type` is
+*    read from or written to the message — shape validation rejects anything that
+*    carries extra fields with the wrong type. Apps that do not install this mock
+*    (older builds) silently ignore the message (natural no-op).
+*
+* Origin policy: neither message type carries sensitive data, so we do NOT
+* restrict by origin — the launcher posts cross-origin from a *.trycloudflare.com
+* tunnel with targetOrigin '*'. Shape validation is still mandatory: a malformed
+* or out-of-range message is silently ignored so a stray postMessage can never
+* corrupt the mock state or trigger spurious navigation.
+*
+* Message-driven by design: env 1 (desktop browser, no launcher) never receives
+* these messages, so the panel preset stays authoritative there with zero special
+* casing here.
+*/
+/** The postMessage envelope the launcher posts to the framed dev app (inset forward). */
+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).
+*/
+const NAVIGATE_BACK_MESSAGE_TYPE = "ait:navigate-back";
+const MAX_INSET_PX = 200;
+function isValidInset(value) {
+	return typeof value === "number" && Number.isFinite(value) && value >= 0 && value <= MAX_INSET_PX;
+}
+/**
+* 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.
+*/
+function parseSafeAreaInsetsMessage(data) {
+	if (typeof data !== "object" || data === null) return null;
+	if (data.type !== "ait:safe-area-insets") return null;
+	const insets = data.insets;
+	if (typeof insets !== "object" || insets === null) return null;
+	const { top, bottom, left, right } = insets;
+	if (!isValidInset(top) || !isValidInset(bottom) || !isValidInset(left) || !isValidInset(right)) return null;
+	return {
+		top,
+		bottom,
+		left,
+		right
+	};
+}
+/**
+* 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.
+*/
+function applyForwardedSafeAreaInsets(insets) {
+	const current = aitState.state.safeAreaInsets;
+	if (current.top === insets.top && current.bottom === insets.bottom && current.left === insets.left && current.right === insets.right) return;
+	aitState.update({ safeAreaInsets: insets });
+}
+let installed = false;
+/**
+* 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.
+*/
+function installSafeAreaInsetsBridge() {
+	if (installed || typeof window === "undefined") return;
+	installed = true;
+	window.addEventListener("message", (event) => {
+		const insets = parseSafeAreaInsetsMessage(event.data);
+		if (insets) applyForwardedSafeAreaInsets(insets);
+	});
+}
+/**
+* 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).
+*/
+function isNavigateBackMessage(data) {
+	if (typeof data !== "object" || data === null) return false;
+	return data.type === NAVIGATE_BACK_MESSAGE_TYPE;
+}
+let navigateBackInstalled = false;
+/**
+* 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).
+*/
+function installNavigateBackBridge() {
+	if (navigateBackInstalled || typeof window === "undefined") return;
+	navigateBackInstalled = true;
+	window.addEventListener("message", (event) => {
+		if (isNavigateBackMessage(event.data)) dispatchHostBackNavigation();
+	});
+}
+/**
+* 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.
+*/
+function installBridges() {
+	installSafeAreaInsetsBridge();
+	installNavigateBackBridge();
+}
+//#endregion
+//#region src/mock/ads/index.ts
+/**
+* 광고 mock (GoogleAdMob, TossAds, FullScreenAd)
+*
+* 변경 이력 (#196):
+* - slot 레지스트리로 TossAds destroy/destroyAll 누수 수정 (🟡→🟢)
+* - attachBanner BannerSlotCallbacks 발화 (onAdRendered/onAdImpression/onNoFill 등)
+* - initialize onInitialized/onInitializationFailed 발화
+* - AdMob reward 파라미터화 (state.ads.rewardUnitType/rewardAmount)
+* - 모든 호출 observe()로 sdkCallLog에 기록
+*/
+function withIsSupported(fn) {
+	fn.isSupported = () => true;
+	return fn;
+}
+const _slotRegistry = /* @__PURE__ */ new Map();
+let _slotCounter = 0;
+function _nextSlotId(adGroupId) {
+	_slotCounter += 1;
+	return `mock-slot-${adGroupId}-${_slotCounter}`;
+}
+const GoogleAdMob = createMockProxy("GoogleAdMob", {
+	loadAppsInTossAdMob: withIsSupported(observe("GoogleAdMob.loadAppsInTossAdMob", "faithful", (args) => {
+		setTimeout(() => {
+			if (aitState.state.ads.forceNoFill) {
+				args.onError(/* @__PURE__ */ new Error("No fill"));
+				return;
+			}
+			aitState.patch("ads", { isLoaded: true });
+			args.onEvent({
+				type: "loaded",
+				data: { adGroupId: args.options?.adGroupId }
+			});
+		}, 200);
+		return () => {};
+	})),
+	showAppsInTossAdMob: withIsSupported(observe("GoogleAdMob.showAppsInTossAdMob", "faithful", (args) => {
+		if (!aitState.state.ads.isLoaded) {
+			args.onError(/* @__PURE__ */ new Error("Ad not loaded"));
+			return () => {};
+		}
+		setTimeout(() => args.onEvent({ type: "requested" }), 50);
+		setTimeout(() => args.onEvent({ type: "show" }), 100);
+		setTimeout(() => args.onEvent({ type: "impression" }), 150);
+		setTimeout(() => {
+			const { rewardUnitType, rewardAmount } = aitState.state.ads;
+			args.onEvent({
+				type: "userEarnedReward",
+				data: {
+					unitType: rewardUnitType,
+					unitAmount: rewardAmount
+				}
+			});
+		}, 1e3);
+		setTimeout(() => {
+			args.onEvent({ type: "dismissed" });
+			aitState.patch("ads", { isLoaded: false });
+		}, 1500);
+		return () => {};
+	})),
+	isAppsInTossAdMobLoaded: withIsSupported(observe("GoogleAdMob.isAppsInTossAdMobLoaded", "faithful", async (_options) => aitState.state.ads.isLoaded))
+});
+const TossAds = createMockProxy("TossAds", {
+	initialize: withIsSupported(observe("TossAds.initialize", "partial", (options) => {
+		if (aitState.state.ads.forceNoFill) {
+			options.callbacks?.onInitializationFailed?.(/* @__PURE__ */ new Error("No fill"));
+			return;
+		}
+		options.callbacks?.onInitialized?.();
+	})),
+	attach: withIsSupported(observe("TossAds.attach", "partial", (_adGroupId, target, _options) => {
+		const el = typeof target === "string" ? document.querySelector(target) : target;
+		if (el) {
+			const placeholder = document.createElement("div");
+			placeholder.style.cssText = "background:#f0f0f0;border:1px dashed #999;padding:16px;text-align:center;color:#666;font-size:14px;";
+			placeholder.textContent = "[@ait-co/devtools] TossAds Placeholder";
+			el.appendChild(placeholder);
+		}
+	})),
+	attachBanner: withIsSupported(observe("TossAds.attachBanner", "faithful", (adGroupId, target, options) => {
+		const el = typeof target === "string" ? document.querySelector(target) : target;
+		const slotId = _nextSlotId(adGroupId);
+		const placeholder = document.createElement("div");
+		const theme = options?.theme ?? "auto";
+		const variant = options?.variant ?? "card";
+		const isDark = theme === "dark" || theme === "auto" && typeof window !== "undefined" && window.matchMedia?.("(prefers-color-scheme: dark)").matches;
+		const bg = isDark ? "#1a1a1a" : "#f0f0f0";
+		const textColor = isDark ? "#aaa" : "#666";
+		const borderColor = isDark ? "#555" : "#999";
+		const height = variant === "expanded" ? "120px" : "60px";
+		placeholder.dataset.aitSlotId = slotId;
+		placeholder.style.cssText = `background:${bg};border:1px dashed ${borderColor};padding:8px 12px;text-align:center;color:${textColor};font-size:12px;min-height:${height};display:flex;align-items:center;justify-content:center;`;
+		placeholder.textContent = `[@ait-co/devtools] Banner Ad (${variant})`;
+		if (el) {
+			el.appendChild(placeholder);
+			_slotRegistry.set(slotId, placeholder);
+		}
+		const destroySlot = () => {
+			const registered = _slotRegistry.get(slotId);
+			if (registered) {
+				registered.remove();
+				_slotRegistry.delete(slotId);
+			}
+		};
+		setTimeout(() => {
+			if (aitState.state.ads.forceNoFill) {
+				options?.callbacks?.onNoFill?.({
+					slotId,
+					adGroupId,
+					adMetadata: {}
+				});
+				options?.callbacks?.onAdFailedToRender?.({
+					slotId,
+					adGroupId,
+					adMetadata: {},
+					error: {
+						code: 0,
+						message: "No fill"
+					}
+				});
+				return;
+			}
+			const eventPayload = {
+				slotId,
+				adGroupId,
+				adMetadata: {
+					creativeId: `mock-creative-${slotId}`,
+					requestId: `mock-req-${slotId}`
+				}
+			};
+			options?.callbacks?.onAdRendered?.(eventPayload);
+			options?.callbacks?.onAdImpression?.(eventPayload);
+		}, 100);
+		return { destroy: destroySlot };
+	})),
+	destroy: withIsSupported(observe("TossAds.destroy", "faithful", (slotId) => {
+		const el = _slotRegistry.get(slotId);
+		if (el) {
+			el.remove();
+			_slotRegistry.delete(slotId);
+		}
+	})),
+	destroyAll: withIsSupported(observe("TossAds.destroyAll", "faithful", () => {
+		for (const el of _slotRegistry.values()) el.remove();
+		_slotRegistry.clear();
+	}))
+});
+const loadFullScreenAd = withIsSupported(observe("loadFullScreenAd", "faithful", (args) => {
+	setTimeout(() => {
+		if (aitState.state.ads.forceNoFill) {
+			args.onError(/* @__PURE__ */ new Error("No fill"));
+			return;
+		}
+		aitState.patch("ads", { isLoaded: true });
+		args.onEvent({
+			type: "loaded",
+			data: { adGroupId: args.options?.adGroupId }
+		});
+	}, 200);
+	return () => {};
+}));
+const showFullScreenAd = withIsSupported(observe("showFullScreenAd", "faithful", (args) => {
+	if (!aitState.state.ads.isLoaded) {
+		args.onError(/* @__PURE__ */ new Error("Ad not loaded"));
+		return () => {};
+	}
+	setTimeout(() => args.onEvent({ type: "show" }), 100);
+	setTimeout(() => args.onEvent({ type: "dismissed" }), 1500);
+	return () => {};
+}));
 //#endregion
-//#region src/mock/device/network.ts
-/**
-* Network Status mock (mode-aware helper)
-* navigation 모듈에서 사용. circular dep 방지를 위해 device에 위치.
-*/
+//#region src/mock/analytics/index.ts
 /**
-* Web mode: uses navigator.connection.effectiveType (4g/3g/2g) and navigator.onLine.
-* Limitations: WIFI, 5G, WWAN cannot be detected via the Network Information API.
-* Falls back to state-based value when effectiveType is unavailable.
+* Analytics mock
 */
-function getNetworkStatusByMode() {
-	const mode = aitState.state.deviceModes.network;
-	if (mode === "mock") return null;
-	if (mode === "web") {
-		if (!navigator.onLine) return "OFFLINE";
-		const conn = navigator.connection;
-		if (conn?.effectiveType) return {
-			"4g": "4G",
-			"3g": "3G",
-			"2g": "2G",
-			"slow-2g": "2G"
-		}[conn.effectiveType] ?? "UNKNOWN";
-		return aitState.state.networkStatus;
+const Analytics = {
+	screen: (params) => {
+		aitState.logAnalytics({
+			type: "screen",
+			params: params ?? {}
+		});
+		return Promise.resolve();
+	},
+	impression: (params) => {
+		aitState.logAnalytics({
+			type: "impression",
+			params: params ?? {}
+		});
+		return Promise.resolve();
+	},
+	click: (params) => {
+		aitState.logAnalytics({
+			type: "click",
+			params: params ?? {}
+		});
+		return Promise.resolve();
 	}
-	return null;
+};
+async function eventLog(params) {
+	aitState.logAnalytics({
+		type: params.log_type,
+		params: {
+			log_name: params.log_name,
+			...params.params
+		}
+	});
 }
 //#endregion
-//#region src/mock/device/pdf.ts
+//#region src/mock/auth/index.ts
 /**
-* Base64로 인코딩된 PDF 데이터를 네이티브 PDF 뷰어로 여는 mock.
-* mock 환경에서는 즉시 `'CLOSE'`를 반환한다.
+* 인증/로그인 mock
 */
-async function openPDFViewer(_params) {
-	await Promise.resolve();
-	return "CLOSE";
+async function appLogin() {
+	return {
+		authorizationCode: `mock-auth-${crypto.randomUUID()}`,
+		referrer: aitState.state.environment === "toss" ? "DEFAULT" : "SANDBOX"
+	};
+}
+async function getIsTossLoginIntegratedService() {
+	return aitState.state.auth.isTossLoginIntegrated;
+}
+async function getUserKeyForGame() {
+	if (!aitState.state.auth.userKeyHash) return void 0;
+	return {
+		hash: aitState.state.auth.userKeyHash,
+		type: "HASH"
+	};
+}
+async function getAnonymousKey() {
+	if (!aitState.state.auth.anonymousKeyHash) return void 0;
+	return {
+		hash: aitState.state.auth.anonymousKeyHash,
+		type: "HASH"
+	};
+}
+async function appsInTossSignTossCert(_params) {
+	console.log("[@ait-co/devtools] appsInTossSignTossCert called (no-op in mock)");
 }
-//#endregion
-//#region src/mock/device/storage.ts
-/**
-* Storage mock
-* localStorage에 `__ait_storage:` prefix로 저장하여 앱 자체 localStorage와 분리
-*/
-const Storage = createMockProxy("Storage", {
-	getItem: async (key) => {
-		return localStorage.getItem(`__ait_storage:${key}`);
-	},
-	setItem: async (key, value) => {
-		localStorage.setItem(`__ait_storage:${key}`, value);
-	},
-	removeItem: async (key) => {
-		localStorage.removeItem(`__ait_storage:${key}`);
-	},
-	clearItems: async () => {
-		const keys = Object.keys(localStorage).filter((k) => k.startsWith("__ait_storage:"));
-		for (const k of keys) localStorage.removeItem(k);
-	}
-});
 //#endregion
 //#region src/mock/game/index.ts
 /**
@@ -1474,145 +1713,6 @@ const requestTossPayPaysBilling = Object.assign(async function requestTossPayPay
 	};
 }, { isSupported: () => true });
 //#endregion
-//#region src/mock/navigation/index.ts
-/**
-* 화면/네비게이션/이벤트 mock
-*/
-async function closeView() {
-	console.log("[@ait-co/devtools] closeView called");
-	window.history.back();
-}
-async function openURL(url) {
-	console.log("[@ait-co/devtools] openURL:", url);
-	window.open(url, "_blank");
-}
-async function share(message) {
-	if (navigator.share) {
-		await navigator.share({ text: message.message });
-		return;
-	}
-	console.log("[@ait-co/devtools] share:", message.message);
-}
-async function getTossShareLink(path, _ogImageUrl) {
-	return `https://toss.im/share/mock${path}`;
-}
-async function setIosSwipeGestureEnabled(options) {
-	console.log("[@ait-co/devtools] setIosSwipeGestureEnabled:", options.isEnabled);
-	aitState.patch("navigation", { iosSwipeGestureEnabled: options.isEnabled });
-}
-async function setDeviceOrientation(options) {
-	const current = aitState.state.viewport.orientation;
-	if (current === "auto") {
-		console.log("[@ait-co/devtools] setDeviceOrientation:", options.type);
-		aitState.patch("viewport", { appOrientation: options.type });
-		return;
-	}
-	console.warn(`[@ait-co/devtools] setDeviceOrientation(${options.type}) ignored — Panel is forcing "${current}". Change the Viewport tab's orientation to "auto" to let the app control rotation.`);
-}
-const setScreenAwakeMode = observe("setScreenAwakeMode", "inert", async (options) => {
-	console.log("[@ait-co/devtools] setScreenAwakeMode:", options.enabled);
-	return { enabled: options.enabled };
-});
-const setSecureScreen = observe("setSecureScreen", "inert", async (options) => {
-	console.log("[@ait-co/devtools] setSecureScreen:", options.enabled);
-	return { enabled: options.enabled };
-});
-const requestReview = observe("requestReview", "inert", async () => {
-	console.log("[@ait-co/devtools] requestReview called");
-});
-requestReview.isSupported = () => true;
-function getPlatformOS() {
-	return aitState.state.platform;
-}
-function getOperationalEnvironment() {
-	return aitState.state.environment;
-}
-function getTossAppVersion() {
-	return aitState.state.appVersion;
-}
-function isMinVersionSupported(minVersions) {
-	const required = aitState.state.platform === "ios" ? minVersions.ios : minVersions.android;
-	if (required === "always") return true;
-	if (required === "never") return false;
-	const current = aitState.state.appVersion.split(".").map(Number);
-	const min = required.split(".").map(Number);
-	for (let i = 0; i < 3; i++) {
-		if ((current[i] ?? 0) > (min[i] ?? 0)) return true;
-		if ((current[i] ?? 0) < (min[i] ?? 0)) return false;
-	}
-	return true;
-}
-function getSchemeUri() {
-	return aitState.state.schemeUri || window.location.pathname;
-}
-function getLocale() {
-	return aitState.state.locale;
-}
-function getDeviceId() {
-	return aitState.state.deviceId;
-}
-function getGroupId() {
-	return aitState.state.groupId;
-}
-async function getNetworkStatus() {
-	const modeResult = getNetworkStatusByMode();
-	if (modeResult) return modeResult;
-	return aitState.state.networkStatus;
-}
-async function getServerTime() {
-	return Date.now();
-}
-getServerTime.isSupported = () => true;
-const graniteEvent = { addEventListener(event, { onEvent, onError }) {
-	const handler = () => {
-		try {
-			onEvent();
-		} catch (e) {
-			onError?.(e instanceof Error ? e : new Error(String(e)));
-		}
-	};
-	window.addEventListener(`__ait:${event}`, handler);
-	return () => window.removeEventListener(`__ait:${event}`, handler);
-} };
-const appsInTossEvent = { addEventListener(_event, _handlers) {
-	return () => {};
-} };
-const tdsEvent = { addEventListener(event, { onEvent }) {
-	const handler = (e) => {
-		const detail = e.detail;
-		onEvent(detail);
-	};
-	window.addEventListener(`__ait:${event}`, handler);
-	return () => window.removeEventListener(`__ait:${event}`, handler);
-} };
-/**
-* @deprecated web-framework 3.0 에서 제거됨. 2.x 소비자 back-compat용으로 유지.
-*/
-function onVisibilityChangedByTransparentServiceWeb(eventParams) {
-	const handler = () => eventParams.onEvent(!document.hidden);
-	document.addEventListener("visibilitychange", handler);
-	return () => document.removeEventListener("visibilitychange", handler);
-}
-const env = { getDeploymentId: () => aitState.state.deploymentId };
-function getAppsInTossGlobals() {
-	return {
-		deploymentId: aitState.state.deploymentId,
-		brandDisplayName: aitState.state.brand.displayName,
-		brandIcon: aitState.state.brand.icon,
-		brandPrimaryColor: aitState.state.brand.primaryColor
-	};
-}
-const SafeAreaInsets = {
-	get: () => ({ ...aitState.state.safeAreaInsets }),
-	subscribe: ({ onEvent }) => {
-		return aitState.subscribe(() => onEvent({ ...aitState.state.safeAreaInsets }));
-	}
-};
-/** @deprecated */
-function getSafeAreaInsets() {
-	return aitState.state.safeAreaInsets.top;
-}
-//#endregion
 //#region src/mock/notification.ts
 /**
 * 알림 동의 mock
@@ -1935,8 +2035,8 @@ function captureCurrentState(snapshot) {
 * @apps-in-toss/web-framework의 모든 export를 mock으로 대체한다.
 * 번들러 alias로 원본 대신 이 모듈이 resolve된다.
 */
-installSafeAreaInsetsBridge();
+installBridges();
 //#endregion
-export { Accuracy, Analytics, FetchAlbumPhotosPermissionError, FetchContactsPermissionError, GetClipboardTextPermissionError, GetCurrentLocationPermissionError, GoogleAdMob, IAP, OpenCameraPermissionError, PermissionError, SAFE_AREA_INSETS_MESSAGE_TYPE, SafeAreaInsets, SetClipboardTextPermissionError, StartUpdateLocationPermissionError, Storage, TossAds, aitState, appLogin, applyForwardedSafeAreaInsets, applyPreset, appsInTossEvent, appsInTossSignTossCert, builtInPresets, captureCurrentState, checkoutPayment, closeView, contactsViral, deleteUserPreset, env, eventLog, fetchAlbumItems, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getAppsInTossGlobals, getClipboardText, getCurrentLocation, getDefaultPlaceholderImages, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPermission, getPlatformOS, getSafeAreaInsets, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, graniteEvent, grantPromotionReward, grantPromotionRewardForGame, installSafeAreaInsetsBridge, isMinVersionSupported, listUserPresets, loadFullScreenAd, matchesPreset, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openPDFViewer, openPermissionDialog, openURL, parseSafeAreaInsetsMessage, partner, requestNotificationAgreement, requestPermission, requestReview, requestTossPayPaysBilling, saveBase64Data, saveUserPreset, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, showFullScreenAd, startUpdateLocation, submitGameCenterLeaderBoardScore, tdsEvent };
+export { Accuracy, Analytics, FetchAlbumPhotosPermissionError, FetchContactsPermissionError, GetClipboardTextPermissionError, GetCurrentLocationPermissionError, GoogleAdMob, IAP, NAVIGATE_BACK_MESSAGE_TYPE, OpenCameraPermissionError, PermissionError, SAFE_AREA_INSETS_MESSAGE_TYPE, SafeAreaInsets, SetClipboardTextPermissionError, StartUpdateLocationPermissionError, Storage, TossAds, aitState, appLogin, applyForwardedSafeAreaInsets, applyPreset, appsInTossEvent, appsInTossSignTossCert, builtInPresets, captureCurrentState, checkoutPayment, closeView, contactsViral, deleteUserPreset, env, eventLog, fetchAlbumItems, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getAppsInTossGlobals, getClipboardText, getCurrentLocation, 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, partner, requestNotificationAgreement, requestPermission, requestReview, requestTossPayPaysBilling, saveBase64Data, saveUserPreset, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, showFullScreenAd, startUpdateLocation, submitGameCenterLeaderBoardScore, tdsEvent };
 
 //# sourceMappingURL=index.js.map