@apps-in-toss/web-bridge 0.0.24

package/build/index.js

@@ -0,0 +1,493 @@
+export * from './bridge.js'
+
+// src/index.ts
+export * from "@apps-in-toss/bridge-core";
+
+// src/storage.ts
+import { createAsyncBridge } from "@apps-in-toss/bridge-core";
+var Storage = {
+  /**
+   * @public
+   * @category 저장소
+   * @name getItem
+   * @description 모바일 앱의 로컬 저장소에서 문자열 데이터를 가져와요. 주로 앱이 종료되었다가 다시 시작해도 데이터가 유지되어야 하는 경우에 사용해요.
+   * @param {string} key - 가져올 아이템의 키를 입력해요.
+   * @returns {Promise<string | null>} 지정한 키에 저장된 문자열 값을 반환해요. 값이 없으면 `null`을 반환해요.
+   * @example
+   *
+   * ### `my-key`에 저장된 아이템 가져오기
+   * ```ts
+   * const value = await Storage.getItem('my-key');
+   * console.log(value); // 'value'
+   * ```
+   */
+  getItem: createAsyncBridge("getStorageItem"),
+  /**
+   * @public
+   * @category 저장소
+   * @name setItem
+   * @description 모바일 앱의 로컬 저장소에 문자열 데이터를 저장해요. 주로 앱이 종료되었다가 다시 시작해도 데이터가 유지되어야 하는 경우에 사용해요.
+   * @param {string} key - 저장할 아이템의 키를 입력해요.
+   * @param {string} value - 저장할 아이템의 값을 입력해요.
+   * @returns {Promise<void>} 아이템을 성공적으로 저장하면 아무 값도 반환하지 않아요.
+   * @example
+   *
+   * ### `my-key`에 아이템 저장하기
+   * ```ts
+   * import { Storage } from '@apps-in-toss/framework';
+   *
+   * await Storage.setItem('my-key', 'value');
+   * ```
+   */
+  setItem: createAsyncBridge("setStorageItem"),
+  /**
+   * @public
+   * @category 저장소
+   * @name removeItem
+   * @description 모바일 앱의 로컬 저장소에서 특정 키에 해당하는 아이템을 삭제해요.
+   * @param {string} key - 삭제할 아이템의 키를 입력해요.
+   * @returns {Promise<void>} 아이템을 삭제하면 아무 값도 반환하지 않아요.
+   * @example
+   *
+   * ### `my-key`에 저장된 아이템 삭제하기
+   * ```ts
+   * import { Storage } from '@apps-in-toss/framework';
+   *
+   * await Storage.removeItem('my-key');
+   * ```
+   */
+  removeItem: createAsyncBridge("removeStorageItem"),
+  /**
+   * @public
+   * @category 저장소
+   * @name clearItems
+   * @description 모바일 앱의 로컬 저장소의 모든 아이템을 삭제해요.
+   * @returns {Promise<void>} 아이템을 삭제하면 아무 값도 반환하지 않고 저장소가 초기화돼요.
+   * @example
+   *
+   * ### 저장소 초기화하기
+   * ```ts
+   * import { Storage } from '@apps-in-toss/framework';
+   *
+   * await Storage.clearItems();
+   * ```
+   */
+  clearItems: createAsyncBridge("clearItems")
+};
+
+// src/getSafeAreaInsets.ts
+import { createConstantBridge } from "@apps-in-toss/bridge-core";
+var getSafeAreaBottom = createConstantBridge("getSafeAreaBottom");
+var getSafeAreaTop = createConstantBridge("getSafeAreaTop");
+function getSafeAreaInsets() {
+  return { top: getSafeAreaTop(), bottom: getSafeAreaBottom() };
+}
+
+// src/googleAdMob.ts
+import { createEventBridge, createConstantBridge as createConstantBridge2 } from "@apps-in-toss/bridge-core";
+var GoogleAdMob = {
+  /**
+   * @public
+   * @category 광고
+   * @name loadAdMobInterstitialAd
+   * @description 앱 화면 전체를 덮는 전면 광고를 미리 불러와서, 광고가 필요한 시점에 바로 보여줄 수 있도록 준비하는 함수예요.
+   * @param {LoadAdMobInterstitialAdParams} params 광고를 불러올 때 사용할 설정 값이에요. 광고 ID와 광고의 동작에 대한 콜백을 설정할 수 있어요.
+   * @param {LoadAdMobInterstitialAdOptions} params.options 광고를 불러올 때 전달할 옵션 객체예요.
+   * @param {string} params.options.adUnitId 광고 단위 ID예요. 발급받은 전면 광고용 ID를 입력해요.
+   * @param {(event: LoadAdMobInterstitialAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고가 닫히거나 클릭됐을 때). 자세한 이벤트 타입은 [LoadAdMobInterstitialAdEvent](/react-native/reference/framework/광고/LoadAdMobInterstitialAdEvent.html)를 참고하세요.
+   * @param {(reason: unknown) => void} [params.onError] 광고를 불러오지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
+   * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
+   *
+   * @example
+   * ### 뷰 진입 시 전면광고 불러오기
+   * ```tsx
+   * import { GoogleAdMob } from '@apps-in-toss/framework';
+   * import { useEffect } from 'react';
+   * import { View, Text } from 'react-native';
+   *
+   * const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
+   *
+   * function Page() {
+   *   useEffect(() => {
+   *     if (GoogleAdMob.loadAdMobInterstitialAd.isSupported() !== true) {
+   *       return;
+   *     }
+   *
+   *     const cleanup = GoogleAdMob.loadAdMobInterstitialAd({
+   *       options: {
+   *         adUnitId: AD_UNIT_ID,
+   *       },
+   *       onEvent: (event) => {
+   *         switch (event.type) {
+   *           case 'loaded':
+   *             console.log('광고 로드 성공', event.data);
+   *             break;
+   *
+   *           case 'clicked':
+   *             console.log('광고 클릭');
+   *             break;
+   *
+   *           case 'dismissed':
+   *             console.log('광고 닫힘');
+   *             break;
+   *
+   *           case 'failedToShow':
+   *             console.log('광고 보여주기 실패');
+   *             break;
+   *
+   *           case 'impression':
+   *             console.log('광고 노출');
+   *             break;
+   *
+   *           case 'show':
+   *             console.log('광고 컨텐츠 보여졌음');
+   *             break;
+   *         }
+   *       },
+   *       onError: (error) => {
+   *         console.error('광고 불러오기 실패', error);
+   *       },
+   *     });
+   *
+   *     return cleanup;
+   *   }, []);
+   *
+   *   return (
+   *     <View>
+   *       <Text>Page</Text>
+   *     </View>
+   *   );
+   * }
+   * ```
+   */
+  loadAdMobInterstitialAd: Object.assign(
+    createEventBridge("loadAdMobInterstitialAd"),
+    {
+      isSupported: createConstantBridge2("loadAdMobInterstitialAd_isSupported")
+    }
+  ),
+  /**
+   * @public
+   * @category 광고
+   * @name showAdMobInterstitialAd
+   * @description 앱 화면 전체를 덮는 전면 광고를 사용자에게 노출해요. 이 함수는 `loadAdMobInterstitialAd` 로 미리 불러온 광고를 실제로 사용자에게 노출해요.
+   * @param {ShowAdMobInterstitialAdParams} params 광고를 보여주기 위해 사용할 설정 값이에요. 광고 ID와과 광고의 동작에 대한 콜백을 설정할 수 있어요.
+   * @param {ShowAdMobInterstitialAdOptions} params.options 광고를 보여줄 때 전달할 옵션 객체예요.
+   * @param {string} params.options.adUnitId 광고 단위 ID예요. `loadAdMobInterstitialAd` 로 불러온 전면 광고용 ID를 입력해요.
+   * @param {(event: ShowAdMobInterstitialAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고 노출을 요청했을 때). 자세한 이벤트 타입은 [ShowAdMobInterstitialAdEvent](/react-native/reference/framework/광고/ShowAdMobInterstitialAdEvent.html)를 참고하세요.
+   * @param {(reason: unknown) => void} [params.onError] 광고를 노출하지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
+   * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
+   *
+   * @example
+   * ### 버튼 눌러 불러온 전면 광고 보여주기
+   * ```tsx
+   * import { GoogleAdMob } from '@apps-in-toss/framework';
+   * import { View, Text, Button } from 'react-native';
+   *
+   * const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
+   *
+   * function Page() {
+   *   const handlePress = () => {
+   *     if (GoogleAdMob.showAdMobInterstitialAd.isSupported() !== true) {
+   *       return;
+   *     }
+   *
+   *     GoogleAdMob.showAdMobInterstitialAd({
+   *       options: {
+   *         adUnitId: AD_UNIT_ID,
+   *       },
+   *       onEvent: (event) => {
+   *         switch (event.type) {
+   *           case 'requested':
+   *             console.log('광고 보여주기 요청 완료');
+   *             break;
+   *         }
+   *       },
+   *       onError: (error) => {
+   *         console.error('광고 보여주기 실패', error);
+   *       },
+   *     });
+   *   }
+   *
+   *   return (
+   *     <Button onPress={handlePress} title="광고 보기" />
+   *   );
+   * }
+   * ```
+   */
+  showAdMobInterstitialAd: Object.assign(
+    createEventBridge("showAdMobInterstitialAd"),
+    {
+      isSupported: createConstantBridge2("showAdMobInterstitialAd_isSupported")
+    }
+  ),
+  /**
+   * @public
+   * @category 광고
+   * @name loadAdMobRewardedAd
+   * @description 사용자가 광고를 끝까지 시청하면 리워드를 제공할 수 있는 보상형 광고를 미리 불러와서, 광고가 필요한 시점에 바로 보여줄 수 있도록 준비하는 함수예요.
+   * @param {LoadAdMobRewardedAdParams} params 광고를 불러올 때 사용할 설정 값이에요. 광고 ID와 광고의 동작에 대한 콜백을 설정할 수 있어요.
+   * @param {LoadAdMobRewardedAdOptions} params.options 광고를 불러올 때 전달할 옵션 객체예요.
+   * @param {string} params.options.adUnitId 광고 단위 ID예요. 발급받은 보상형 광고용 ID를 입력해요.
+   * @param {(event: LoadAdMobRewardedAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고가 닫히거나 클릭됐을 때). 자세한 이벤트 타입은 [LoadAdMobRewardedAdEvent](/react-native/reference/framework/광고/LoadAdMobRewardedAdEvent.html)를 참고하세요.
+   * @param {(reason: unknown) => void} [params.onError] 광고를 불러오지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
+   * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
+   *
+   * @example
+   * ### 뷰 진입 시 보상형 광고 불러오기
+   * ```tsx
+   * import { GoogleAdMob } from '@apps-in-toss/framework';
+   * import { useEffect } from 'react';
+   * import { View, Text } from 'react-native';
+   *
+   * const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
+   *
+   * function Page() {
+   *   useEffect(() => {
+   *     if (GoogleAdMob.loadAdMobRewardedAd.isSupported() !== true) {
+   *       return;
+   *     }
+   *
+   *     const cleanup = GoogleAdMob.loadAdMobRewardedAd({
+   *       options: {
+   *         adUnitId: AD_UNIT_ID,
+   *       },
+   *       onEvent: (event) => {
+   *         switch (event.type) {
+   *           case 'loaded':
+   *             console.log('광고 로드 성공', event.data);
+   *             break;
+   *
+   *           case 'clicked':
+   *             console.log('광고 클릭');
+   *             break;
+   *
+   *           case 'dismissed':
+   *             console.log('광고 닫힘');
+   *             break;
+   *
+   *           case 'failedToShow':
+   *             console.log('광고 보여주기 실패');
+   *             break;
+   *
+   *           case 'impression':
+   *             console.log('광고 노출');
+   *             break;
+   *
+   *           case 'show':
+   *             console.log('광고 컨텐츠 보여졌음');
+   *             break;
+   *
+   *           case 'userEarnedReward':
+   *             console.log('사용자가 광고 시청을 완료했음');
+   *             break;
+   *         }
+   *       },
+   *       onError: (error) => {
+   *         console.error('광고 불러오기 실패', error);
+   *       },
+   *     });
+   *
+   *     return cleanup;
+   *   }, []);
+   *
+   *   return (
+   *     <View>
+   *       <Text>Page</Text>
+   *     </View>
+   *   );
+   * }
+   * ```
+   */
+  loadAdMobRewardedAd: Object.assign(createEventBridge("loadAdMobRewardedAd"), {
+    isSupported: createConstantBridge2("loadAdMobRewardedAd_isSupported")
+  }),
+  /**
+   * @public
+   * @category 광고
+   * @name showAdMobRewardedAd
+   * @description 사용자가 광고를 끝까지 보면 리워드를 받을 수 있도록, 보상형 광고를 화면에 보여줘요. 이 함수는 `loadAdMobRewardedAd` 로 미리 불러온 광고를 실제로 사용자에게 노출해요.
+   * @param {ShowAdMobRewardedAdParams} params 광고를 보여주기 위해 사용할 설정 값이에요. 광고 ID와 광고의 동작에 대한 콜백을 설정할 수 있어요.
+   * @param {ShowAdMobRewardedAdOptions} params.options 광고를 보여줄 때 전달할 옵션 객체예요.
+   * @param {string} params.options.adUnitId 광고 단위 ID예요. `loadAdMobRewardedAd` 로 불러온 보상형 광고용 ID를 입력해요.
+   * @param {(event: ShowAdMobRewardedAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고 노출을 요청했을 때). 자세한 이벤트 타입은 [ShowAdMobRewardedAdEvent](/react-native/reference/framework/광고/ShowAdMobRewardedAdEvent.html)를 참고하세요.
+   * @param {(reason: unknown) => void} [params.onError] 광고를 불러오지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
+   * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
+   *
+   * @example
+   * ### 버튼 눌러 불러온 보상형 광고 보여주기
+   * ```tsx
+   * import { GoogleAdMob } from '@apps-in-toss/framework';
+   * import { View, Text, Button } from 'react-native';
+   *
+   * const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
+   *
+   * function Page() {
+   *   const handlePress = () => {
+   *     if (GoogleAdMob.showAdMobRewardedAd.isSupported() !== true) {
+   *       return;
+   *     }
+   *
+   *     GoogleAdMob.showAdMobRewardedAd({
+   *       options: {
+   *         adUnitId: AD_UNIT_ID,
+   *       },
+   *       onEvent: (event) => {
+   *         switch (event.type) {
+   *           case 'requested':
+   *             console.log('광고 보여주기 요청 완료');
+   *             break;
+   *         }
+   *       },
+   *       onError: (error) => {
+   *         console.error('광고 보여주기 실패', error);
+   *       },
+   *     });
+   *   }
+   *
+   *   return (
+   *     <Button onPress={handlePress} title="광고 보기" />
+   *   );
+   * }
+   * ```
+   */
+  showAdMobRewardedAd: Object.assign(createEventBridge("showAdMobRewardedAd"), {
+    isSupported: createConstantBridge2("showAdMobRewardedAd_isSupported")
+  })
+};
+
+// src/bedrockEvent.ts
+import { createEventBridge as createEventBridge2 } from "@apps-in-toss/bridge-core";
+var bedrockEvent = {
+  addEventListener: (event, {
+    onEvent,
+    onError,
+    options
+  }) => createEventBridge2(event)({
+    onEvent,
+    onError: onError ?? (() => {
+    }),
+    options
+  })
+};
+
+// src/isMinVersionSupported.ts
+import { createConstantBridge as createConstantBridge3 } from "@apps-in-toss/bridge-core";
+
+// src/utils/compareVersion.ts
+var SEMVER_REGEX = /^[v^~<>=]*?(\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+))?(?:-([\da-z\\-]+(?:\.[\da-z\\-]+)*))?(?:\+[\da-z\\-]+(?:\.[\da-z\\-]+)*)?)?)?$/i;
+var isWildcard = (val) => ["*", "x", "X"].includes(val);
+var tryParse = (val) => {
+  const num = parseInt(val, 10);
+  return isNaN(num) ? val : num;
+};
+var coerceTypes = (a, b) => {
+  return typeof a === typeof b ? [a, b] : [String(a), String(b)];
+};
+var compareValues = (a, b) => {
+  if (isWildcard(a) || isWildcard(b)) {
+    return 0;
+  }
+  const [aVal, bVal] = coerceTypes(tryParse(a), tryParse(b));
+  if (aVal > bVal) {
+    return 1;
+  }
+  if (aVal < bVal) {
+    return -1;
+  }
+  return 0;
+};
+var parseVersion = (version) => {
+  if (typeof version !== "string") {
+    throw new TypeError("Invalid argument: expected a string");
+  }
+  const match = version.match(SEMVER_REGEX);
+  if (!match) {
+    throw new Error(`Invalid semver: '${version}'`);
+  }
+  const [, major, minor, patch, build, preRelease] = match;
+  return [major, minor, patch, build, preRelease];
+};
+var compareSegments = (a, b) => {
+  const maxLength = Math.max(a.length, b.length);
+  for (let i = 0; i < maxLength; i++) {
+    const segA = a[i] ?? "0";
+    const segB = b[i] ?? "0";
+    const result = compareValues(segA, segB);
+    if (result !== 0) {
+      return result;
+    }
+  }
+  return 0;
+};
+var compareVersions = (v1, v2) => {
+  const seg1 = parseVersion(v1);
+  const seg2 = parseVersion(v2);
+  const preRelease1 = seg1.pop();
+  const preRelease2 = seg2.pop();
+  const mainCompare = compareSegments(seg1, seg2);
+  if (mainCompare !== 0) {
+    return mainCompare;
+  }
+  if (preRelease1 && preRelease2) {
+    return compareSegments(preRelease1.split("."), preRelease2.split("."));
+  }
+  if (preRelease1) {
+    return -1;
+  }
+  if (preRelease2) {
+    return 1;
+  }
+  return 0;
+};
+
+// src/isMinVersionSupported.ts
+function isMinVersionSupported(minVersions) {
+  const operationalEnvironment = createConstantBridge3("getOperationalEnvironment")();
+  if (operationalEnvironment === "sandbox") {
+    return true;
+  }
+  const currentVersion = createConstantBridge3("getTossAppVersion")();
+  const isIOS = createConstantBridge3("getPlatformOS")() === "ios";
+  const minVersion = isIOS ? minVersions.ios : minVersions.android;
+  if (minVersion === void 0) {
+    return false;
+  }
+  if (minVersion === "always") {
+    return true;
+  }
+  if (minVersion === "never") {
+    return false;
+  }
+  return compareVersions(currentVersion, minVersion) >= 0;
+}
+
+// src/appsInTossEvent.ts
+import { createEventBridge as createEventBridge3 } from "@apps-in-toss/bridge-core";
+var appsInTossEvent = {
+  addEventListener: (event, {
+    onEvent,
+    onError,
+    options
+  }) => createEventBridge3(event)({
+    onEvent,
+    onError: onError ?? (() => {
+    }),
+    options
+  })
+};
+
+// src/env.ts
+import { createConstantBridge as createConstantBridge4 } from "@apps-in-toss/bridge-core";
+var env = {
+  getDeploymentId: createConstantBridge4("getDeploymentId")
+};
+export {
+  GoogleAdMob,
+  Storage,
+  appsInTossEvent,
+  bedrockEvent,
+  env,
+  getSafeAreaInsets,
+  isMinVersionSupported
+};

package/build/openCamera.d.ts

@@ -0,0 +1,78 @@
+/**
+ * 사진 조회 결과를 나타내는 타입이에요.
+ */
+export interface ImageResponse {
+	/** 가져온 사진의 고유 ID예요. */
+	id: string;
+	/** 사진의 데이터 URI예요. `base64` 옵션이 `true`인 경우 Base64 문자열로 반환돼요. */
+	dataUri: string;
+}
+export interface OpenCameraOptions {
+	/**
+	 * 이미지를 Base64 형식으로 반환할지 여부를 나타내는 불리언 값이에요.
+	 *
+	 * 기본값: `false`.
+	 */
+	base64?: boolean;
+	/**
+	 * 이미지의 최대 너비를 나타내는 숫자 값이에요.
+	 *
+	 * 기본값: `1024`.
+	 */
+	maxWidth?: number;
+}
+/**
+ * @public
+ * @category 카메라
+ * @name openCamera
+ * @description 카메라를 실행해서 촬영된 이미지를 반환하는 함수예요.
+ * @param {OpenCameraOptions} options - 카메라 실행 시 사용되는 옵션 객체예요.
+ * @param {boolean} [options.base64=false] - 이미지를 Base64 형식으로 반환할지 여부를 나타내는 불리언 값이에요. 기본값은 `false`예요. `true`로 설정하면 `dataUri` 대신 Base64 인코딩된 문자열을 반환해요.
+ * @param {number} [options.maxWidth=1024] - 이미지의 최대 너비를 나타내는 숫자 값이에요. 기본값은 `1024`예요.
+ * @returns {Promise<ImageResponse>}
+ * 촬영된 이미지 정보를 포함한 객체를 반환해요. 반환 객체의 구성은 다음과 같아요:
+ * - `id`: 이미지의 고유 식별자예요.
+ * - `dataUri`: 이미지 데이터를 표현하는 데이터 URI예요.
+ *
+ * @example
+ * ### 카메라 실행 후 촬영된 사진 가져오기
+ *
+ * ```tsx
+ * import React, { useState } from 'react';
+ * 
+ * import { openCamera } from '@apps-in-toss/web-framework';
+ *
+ * const base64 = true;
+ *
+ * // 카메라를 실행하고 촬영된 이미지를 화면에 표시하는 컴포넌트
+ * function Camera() {
+ *   const [image, setImage] = useState(null);
+ *
+ *   const handlePress = async () => {
+ *     try {
+ *       const response = await openCamera({ base64 });
+ *       setImage(response);
+ *     } catch (error) {
+ *       console.error('사진을 가져오는 데 실패했어요:', error);
+ *     }
+ *   };
+ *
+ *   // base64 형식으로 반환된 이미지를 표시하려면 데이터 URL 스키마 Prefix를 붙여야해요.
+ *   const imageUri = base64 ? 'data:image/jpeg;base64,' + image.dataUri : image.dataUri;
+ *
+ *   return (
+ *     <div>
+ *       {image ? (
+ *         <Image source={{ uri: imageUri }} style={{ width: 200, height: 200 }} />
+ *       ) : (
+ *         <span>사진이 없어요</span>
+ *       )}
+ *       <input type="button" value="사진 촬영하기" onClick={handlePress} />
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function openCamera(options?: OpenCameraOptions): Promise<ImageResponse>;
+
+export {};

package/build/openURL.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @public
+ * @kind function
+ * @category 화면 이동
+ *
+ * @name openURL
+ * @signature
+ * ```typescript
+ * function openURL(url: string): Promise<any>;
+ * ```
+ *
+ * @description
+ * 지정된 URL을 기기의 기본 브라우저나 관련 앱에서 열어요.
+ * 이 함수는 `react-native`의 [`Linking.openURL`](https://reactnative.dev/docs/0.72/linking#openurl) 메서드를 사용하여 URL을 열어요.
+ *
+ * @param {string} url 열고자 하는 URL 주소
+ * @returns {Promise<any>} URL이 성공적으로 열렸을 때 해결되는 Promise
+ *
+ * @example
+ *
+ * ### 외부 URL 열기
+ *
+ * ```tsx
+ * import { openURL } from '@apps-in-toss/web-framework';
+ * 
+ *
+ * function Page() {
+ *   const handlePress = () => {
+ *     openURL('https://google.com');
+ *   };
+ *
+ *   return <input type="button" value="구글 웹사이트 열기" onClick={handlePress} />;
+ * }
+ * ```
+ */
+export declare function openURL(url: string): Promise<any>;
+
+export {};

package/build/setClipboardText.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @public
+ * @category 클립보드
+ * @name setClipboardText
+ * @description 텍스트를 클립보드에 복사해서 사용자가 다른 곳에 붙여 넣기 할 수 있어요.
+ * @param {Promise<void>} text - 클립보드에 복사할 텍스트예요. 문자열 형식으로 입력해요.
+ *
+ * @example
+ * ### 텍스트를 클립보드에 복사하기
+ *
+ * ```tsx
+ * 
+ * import { setClipboardText } from '@apps-in-toss/web-framework';
+ *
+ * // '복사' 버튼을 누르면 "복사할 텍스트"가 클립보드에 복사돼요.
+ * function CopyButton() {
+ *   const handleCopy = async () => {
+ *     try {
+ *       await setClipboardText('복사할 텍스트');
+ *       console.log('텍스트가 복사됐어요!');
+ *     } catch (error) {
+ *       console.error('텍스트 복사에 실패했어요:', error);
+ *     }
+ *   };
+ *
+ *   return <input type="button" value="복사" onClick={handleCopy} />;
+ * }
+ * ```
+ */
+export declare function setClipboardText(text: string): Promise<void>;
+
+export {};

package/build/setIosSwipeGestureEnabled.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @public
+ * @category 화면 제어
+ * @name setIosSwipeGestureEnabled
+ * @description
+ * `setIosSwipeGestureEnabled` 함수는 iOS에서 화면을 스와이프하여 뒤로가기 기능을 활성화하거나 비활성화할 수 있어요.
+ *
+ * @param {object} options 스와이프하여 뒤로가기 기능을 활성화하거나 비활성화하는 옵션이에요.
+ * @param {boolean} options.isEnabled 화면을 스와이프하여 뒤로가기 기능을 활성화하거나 비활성화할 수 있어요. `true`를 설정하면 스와이프로 뒤로갈 수 있고, `false`를 설정하면 스와이프 뒤로가기 기능이 비활성화돼요.
+ *
+ * @returns {void}
+ *
+ * @example
+ *
+ * ### iOS에서 화면 스와이프로 뒤로가기 기능을 활성화하거나 비활성화하기
+ *
+ * **스와이프 끄기** 버튼을 눌러 화면 스와이프로 뒤로가기 기능을 비활성화하거나, **스와이프 켜기** 버튼을 눌러 화면 스와이프로 뒤로가기 기능을 활성화할 수 있어요.
+ *
+ *
+ * ```tsx
+ * import { setIosSwipeGestureEnabled } from '@apps-in-toss/web-framework';
+ * 
+ *
+ * function Page() {
+ *  return (
+ *    <>
+ *     <input type="button" value="스와이프 끄기" onClick={() => setIosSwipeGestureEnabled({ isEnabled: false })} />
+ *     <input type="button" value="스와이프 켜기" onClick={() => setIosSwipeGestureEnabled({ isEnabled: true })} />
+ *    </>
+ *  );
+ * }
+ * ```
+ *
+ */
+export declare function setIosSwipeGestureEnabled(options: {
+	isEnabled: boolean;
+}): Promise<void>;
+
+export {};