@apps-in-toss/framework 0.0.26 → 0.0.28

package/dist/index.cjs

@@ -53,6 +53,7 @@ __export(src_exports, {
   isMinVersionSupported: () => isMinVersionSupported,
   openCamera: () => openCamera,
   setClipboardText: () => setClipboardText,
+  setDeviceOrientation: () => setDeviceOrientation,
   startUpdateLocation: () => startUpdateLocation,
   useGeolocation: () => useGeolocation
 });
@@ -471,7 +472,8 @@ __export(async_bridges_exports, {
   getCurrentLocation: () => getCurrentLocation,
   getTossShareLink: () => getTossShareLink,
   openCamera: () => openCamera,
-  setClipboardText: () => setClipboardText
+  setClipboardText: () => setClipboardText,
+  setDeviceOrientation: () => setDeviceOrientation
 });
 
 // src/native-modules/setClipboardText.ts
@@ -598,6 +600,18 @@ async function getTossShareLink(path) {
   return shareUrl.toString();
 }
 
+// src/native-modules/setDeviceOrientation.ts
+async function setDeviceOrientation(options) {
+  const isSupported = isMinVersionSupported({
+    android: "5.215.0",
+    ios: "5.215.0"
+  });
+  if (!isSupported) {
+    return;
+  }
+  return AppsInTossModule.setDeviceOrientation(options);
+}
+
 // src/core/registerApp.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
 function AppsInTossContainer(Container, { children, ...initialProps }) {
@@ -1346,6 +1360,7 @@ var Analytics2 = {
   isMinVersionSupported,
   openCamera,
   setClipboardText,
+  setDeviceOrientation,
   startUpdateLocation,
   useGeolocation,
   ...require("@apps-in-toss/analytics")

package/dist/index.d.cts

@@ -1652,6 +1652,70 @@ declare function eventLog(params: EventLogParams): Promise<void>;
  */
 declare function getTossShareLink(path: string): Promise<string>;
 
+/**
+ * @public
+ * @category 화면 제어
+ * @kind function
+ * @name setDeviceOrientation
+ * @description
+ * `setDeviceOrientation` 함수는 기기의 화면 방향을 설정하는 기능을 제공해요.
+ * 이 기능은 특정 화면에서 가로 모드나 세로 모드를 강제로 지정해야 할 때 유용해요.
+ *
+ * `type` 옵션을 통해 원하는 화면 방향을 지정할 수 있어요. 특히, 이 함수는 앱 전체에 영향을 미치므로
+ * 특정 화면에서만 사용하려면 화면을 벗어날 때 이전 상태로 복구하는 추가 작업이 필요해요.
+ *
+ * 예를 들어, 동영상 감상 화면에서는 가로 모드를 강제하고, 화면을 떠날 때 설정을 복구해서
+ * 다른 화면들의 방향 설정에 영향을 주지 않도록 할 수 있어요.
+ *
+ * @param {object} options 화면 방향 설정 값이에요.
+ * @param {string} options.type 화면 방향을 지정하는 옵션이에요.
+ * 'portrait' | 'landscape' 중 하나를 선택할 수 있어요.
+ *
+ * @returns {Promise<void>} 화면 방향 설정이 완료되면 해결되는 Promise를 반환해요.
+ *
+ * @example
+ * ### 화면 방향 설정하기
+ *
+ * ```tsx
+ * import { Button } from 'react-native';
+ * import { setDeviceOrientation } from '@apps-in-toss/framework';
+ *
+ * function SetDeviceOrientation() {
+ *   return (
+ *     <Button
+ *       title="가로 모드로 변경"
+ *       onPress={() => {
+ *         setDeviceOrientation({ type: 'landscape' });
+ *       }}
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * ### 화면 방향 복구하기
+ * 특정 화면을 벗어날 때 이전 상태로 복구하려면 다음과 같이 `useEffect`를 사용하세요.
+ *
+ * ```tsx
+ * import { useEffect } from 'react';
+ * import { setDeviceOrientation } from '@apps-in-toss/framework';
+ *
+ * function VideoScreen() {
+ *   useEffect(() => {
+ *     setDeviceOrientation({ type: 'landscape' });
+ *
+ *     return () => {
+ *       setDeviceOrientation({ type: 'portrait' }); // 설정을 이전 상태로 복구해요.
+ *     };
+ *   }, []);
+ *
+ *   return <Text>동영상을 감상하는 화면</Text>;
+ * }
+ * ```
+ */
+declare function setDeviceOrientation(options: {
+    type: 'portrait' | 'landscape';
+}): Promise<void>;
+
 /**
  * @public
  * @category 토스페이
@@ -1804,4 +1868,4 @@ declare const Analytics: {
     Area: ({ children, params: _params, ...props }: _apps_in_toss_analytics.LoggingAreaProps) => react_jsx_runtime.JSX.Element;
 };
 
-export { Accuracy, Analytics, AppsInToss, type ContactEntity, type EventLogParams, type ExternalWebViewProps, type FetchAlbumPhotosOptions, type GameWebViewProps, type GetCurrentLocationOptions, GoogleAdMob, type ImageResponse, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type Location, type LocationCoords, type OpenCameraOptions, type PartnerWebViewProps, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, type StartUpdateLocationOptions$1 as StartUpdateLocationOptions, type StartUpdateLocationSubscription, Storage, TossPay, type UpdateLocationEventEmitter, type UseGeolocationOptions, WebView, type WebViewProps, appLogin, appsInTossEvent, env, eventLog, fetchAlbumPhotos, fetchContacts, getClipboardText, getCurrentLocation, getDeviceId, getOperationalEnvironment, getTossAppVersion, getTossShareLink, isMinVersionSupported, openCamera, setClipboardText, startUpdateLocation, useGeolocation };
+export { Accuracy, Analytics, AppsInToss, type ContactEntity, type EventLogParams, type ExternalWebViewProps, type FetchAlbumPhotosOptions, type GameWebViewProps, type GetCurrentLocationOptions, GoogleAdMob, type ImageResponse, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type Location, type LocationCoords, type OpenCameraOptions, type PartnerWebViewProps, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, type StartUpdateLocationOptions$1 as StartUpdateLocationOptions, type StartUpdateLocationSubscription, Storage, TossPay, type UpdateLocationEventEmitter, type UseGeolocationOptions, WebView, type WebViewProps, appLogin, appsInTossEvent, env, eventLog, fetchAlbumPhotos, fetchContacts, getClipboardText, getCurrentLocation, getDeviceId, getOperationalEnvironment, getTossAppVersion, getTossShareLink, isMinVersionSupported, openCamera, setClipboardText, setDeviceOrientation, startUpdateLocation, useGeolocation };

package/dist/index.d.ts

@@ -1652,6 +1652,70 @@ declare function eventLog(params: EventLogParams): Promise<void>;
  */
 declare function getTossShareLink(path: string): Promise<string>;
 
+/**
+ * @public
+ * @category 화면 제어
+ * @kind function
+ * @name setDeviceOrientation
+ * @description
+ * `setDeviceOrientation` 함수는 기기의 화면 방향을 설정하는 기능을 제공해요.
+ * 이 기능은 특정 화면에서 가로 모드나 세로 모드를 강제로 지정해야 할 때 유용해요.
+ *
+ * `type` 옵션을 통해 원하는 화면 방향을 지정할 수 있어요. 특히, 이 함수는 앱 전체에 영향을 미치므로
+ * 특정 화면에서만 사용하려면 화면을 벗어날 때 이전 상태로 복구하는 추가 작업이 필요해요.
+ *
+ * 예를 들어, 동영상 감상 화면에서는 가로 모드를 강제하고, 화면을 떠날 때 설정을 복구해서
+ * 다른 화면들의 방향 설정에 영향을 주지 않도록 할 수 있어요.
+ *
+ * @param {object} options 화면 방향 설정 값이에요.
+ * @param {string} options.type 화면 방향을 지정하는 옵션이에요.
+ * 'portrait' | 'landscape' 중 하나를 선택할 수 있어요.
+ *
+ * @returns {Promise<void>} 화면 방향 설정이 완료되면 해결되는 Promise를 반환해요.
+ *
+ * @example
+ * ### 화면 방향 설정하기
+ *
+ * ```tsx
+ * import { Button } from 'react-native';
+ * import { setDeviceOrientation } from '@apps-in-toss/framework';
+ *
+ * function SetDeviceOrientation() {
+ *   return (
+ *     <Button
+ *       title="가로 모드로 변경"
+ *       onPress={() => {
+ *         setDeviceOrientation({ type: 'landscape' });
+ *       }}
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * ### 화면 방향 복구하기
+ * 특정 화면을 벗어날 때 이전 상태로 복구하려면 다음과 같이 `useEffect`를 사용하세요.
+ *
+ * ```tsx
+ * import { useEffect } from 'react';
+ * import { setDeviceOrientation } from '@apps-in-toss/framework';
+ *
+ * function VideoScreen() {
+ *   useEffect(() => {
+ *     setDeviceOrientation({ type: 'landscape' });
+ *
+ *     return () => {
+ *       setDeviceOrientation({ type: 'portrait' }); // 설정을 이전 상태로 복구해요.
+ *     };
+ *   }, []);
+ *
+ *   return <Text>동영상을 감상하는 화면</Text>;
+ * }
+ * ```
+ */
+declare function setDeviceOrientation(options: {
+    type: 'portrait' | 'landscape';
+}): Promise<void>;
+
 /**
  * @public
  * @category 토스페이
@@ -1804,4 +1868,4 @@ declare const Analytics: {
     Area: ({ children, params: _params, ...props }: _apps_in_toss_analytics.LoggingAreaProps) => react_jsx_runtime.JSX.Element;
 };
 
-export { Accuracy, Analytics, AppsInToss, type ContactEntity, type EventLogParams, type ExternalWebViewProps, type FetchAlbumPhotosOptions, type GameWebViewProps, type GetCurrentLocationOptions, GoogleAdMob, type ImageResponse, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type Location, type LocationCoords, type OpenCameraOptions, type PartnerWebViewProps, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, type StartUpdateLocationOptions$1 as StartUpdateLocationOptions, type StartUpdateLocationSubscription, Storage, TossPay, type UpdateLocationEventEmitter, type UseGeolocationOptions, WebView, type WebViewProps, appLogin, appsInTossEvent, env, eventLog, fetchAlbumPhotos, fetchContacts, getClipboardText, getCurrentLocation, getDeviceId, getOperationalEnvironment, getTossAppVersion, getTossShareLink, isMinVersionSupported, openCamera, setClipboardText, startUpdateLocation, useGeolocation };
+export { Accuracy, Analytics, AppsInToss, type ContactEntity, type EventLogParams, type ExternalWebViewProps, type FetchAlbumPhotosOptions, type GameWebViewProps, type GetCurrentLocationOptions, GoogleAdMob, type ImageResponse, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type Location, type LocationCoords, type OpenCameraOptions, type PartnerWebViewProps, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, type StartUpdateLocationOptions$1 as StartUpdateLocationOptions, type StartUpdateLocationSubscription, Storage, TossPay, type UpdateLocationEventEmitter, type UseGeolocationOptions, WebView, type WebViewProps, appLogin, appsInTossEvent, env, eventLog, fetchAlbumPhotos, fetchContacts, getClipboardText, getCurrentLocation, getDeviceId, getOperationalEnvironment, getTossAppVersion, getTossShareLink, isMinVersionSupported, openCamera, setClipboardText, setDeviceOrientation, startUpdateLocation, useGeolocation };

package/dist/index.js

@@ -419,7 +419,8 @@ __export(async_bridges_exports, {
   getCurrentLocation: () => getCurrentLocation,
   getTossShareLink: () => getTossShareLink,
   openCamera: () => openCamera,
-  setClipboardText: () => setClipboardText
+  setClipboardText: () => setClipboardText,
+  setDeviceOrientation: () => setDeviceOrientation
 });
 
 // src/native-modules/setClipboardText.ts
@@ -546,6 +547,18 @@ async function getTossShareLink(path) {
   return shareUrl.toString();
 }
 
+// src/native-modules/setDeviceOrientation.ts
+async function setDeviceOrientation(options) {
+  const isSupported = isMinVersionSupported({
+    android: "5.215.0",
+    ios: "5.215.0"
+  });
+  if (!isSupported) {
+    return;
+  }
+  return AppsInTossModule.setDeviceOrientation(options);
+}
+
 // src/core/registerApp.tsx
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 function AppsInTossContainer(Container, { children, ...initialProps }) {
@@ -1298,6 +1311,7 @@ export {
   isMinVersionSupported,
   openCamera,
   setClipboardText,
+  setDeviceOrientation,
   startUpdateLocation,
   useGeolocation
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/framework",
   "type": "module",
-  "version": "0.0.26",
+  "version": "0.0.28",
   "description": "The framework for Apps In Toss",
   "scripts": {
     "prepack": "yarn build",
@@ -57,16 +57,16 @@
     "ait": "./bin/ait.js"
   },
   "dependencies": {
-    "@apps-in-toss/analytics": "0.0.26",
-    "@apps-in-toss/cli": "0.0.26",
-    "@apps-in-toss/plugins": "0.0.26",
+    "@apps-in-toss/analytics": "0.0.28",
+    "@apps-in-toss/cli": "0.0.28",
+    "@apps-in-toss/plugins": "0.0.28",
     "es-hangul": "^2.3.2"
   },
   "devDependencies": {
-    "@react-native-bedrock/mpack-next": "0.0.24",
-    "@react-native-bedrock/native": "0.0.24",
-    "@react-native-bedrock/plugin-core": "0.0.24",
-    "@react-native-bedrock/utils": "0.0.24",
+    "@react-native-bedrock/mpack-next": "0.0.25",
+    "@react-native-bedrock/native": "0.0.25",
+    "@react-native-bedrock/plugin-core": "0.0.25",
+    "@react-native-bedrock/utils": "0.0.25",
     "@toss-design-system/react-native": "^0.5.0",
     "@types/kill-port": "^2.0.1",
     "@types/react": "18.3.3",
@@ -76,7 +76,7 @@
     "kill-port": "^2.0.1",
     "react": "18.2.0",
     "react-native": "0.72.6",
-    "react-native-bedrock": "0.0.24",
+    "react-native-bedrock": "0.0.25",
     "tsup": "^8.3.5",
     "typescript": "5.8.3",
     "vitest": "^3.0.3",
@@ -93,5 +93,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "8df951171a6a432852d863459d724224a0680e7d"
+  "gitHead": "17b4c5583054e58a9da274a886ee10c76671d24d"
 }

package/src/async-bridges.ts

@@ -8,3 +8,4 @@ export * from './native-modules/appLogin';
 export * from './native-modules/checkoutPayment';
 export * from './native-modules/eventLog';
 export * from './native-modules/getTossShareLink';
+export * from './native-modules/setDeviceOrientation';