feat: Runtime-Mutable Properties Converted to Methods (#34)

* build: set tsconfig

* feat: change apis

* feat: change native impl

* docs: apply changes in documents

* feat: apply changes in examples

* docs: apply changes in README, CHANGELOG

* ci: fix ktlintFormat

* docs: apply changelog

* Update src/DeviceInfo.nitro.ts

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: l2hyunwoo

CHANGELOG.md

@@ -5,10 +5,15 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [1.3.0] - 2025-11-29
 
 ### Added
 
+- **System Language & Navigation Mode API**: New localization and navigation detection capabilities
+  - `systemLanguage`: Get device system language in BCP 47 format (e.g., "en-US", "ko-KR")
+  - `navigationMode`: Detect Android navigation mode (`'gesture' | 'buttons' | 'twobuttons' | 'unknown'`)
+  - `NavigationMode` type: New TypeScript type for navigation mode values
+
 - **Complete API Migration**: All APIs from `react-native-device-info` have been migrated
   - Full feature parity with the original library
   - All device information methods now available through Nitro Modules
@@ -22,6 +27,57 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Automated CI/CD deployment to GitHub Pages
   - Visit at: https://l2hyunwoo.github.io/react-native-nitro-device-info/
 
+### Changed
+
+#### BREAKING: Runtime-Mutable Properties Converted to Methods (18 APIs)
+
+Properties that return values which can change during app runtime have been converted from readonly properties to synchronous getter methods. This provides clearer semantics - methods indicate "query on each call" while properties implied cached/stable values.
+
+**Battery & Power** (3 APIs):
+
+- `batteryLevel` → `getBatteryLevel()`: Returns current battery level (0.0-1.0)
+- `powerState` → `getPowerState()`: Returns PowerState object
+- `isBatteryCharging` → `getIsBatteryCharging()`: Returns charging status
+
+**System Resources** (3 APIs):
+
+- `usedMemory` → `getUsedMemory()`: Returns current app memory usage
+- `freeDiskStorage` → `getFreeDiskStorage()`: Returns free disk space
+- `freeDiskStorageOld` → `getFreeDiskStorageOld()`: Returns free disk space (legacy API)
+
+**Audio/Peripherals** (3 APIs):
+
+- `isWiredHeadphonesConnected` → `getIsWiredHeadphonesConnected()`: Wired headphone detection
+- `isBluetoothHeadphonesConnected` → `getIsBluetoothHeadphonesConnected()`: Bluetooth headphone detection
+- `isHeadphonesConnectedSync` → `getIsHeadphonesConnected()`: Any headphone detection
+
+**Network & Connectivity** (6 APIs):
+
+- `isAirplaneMode` → `getIsAirplaneMode()`: Airplane mode status (Android only)
+- `ipAddressSync` → `getIpAddressSync()`: Current IP address (cached 5s)
+- `carrierSync` → `getCarrierSync()`: Carrier name (cached 5s)
+- `isLocationEnabledSync` → `getIsLocationEnabled()`: Location services status
+- `macAddressSync` → `getMacAddressSync()`: MAC address (cached 5s)
+- `availableLocationProviders` → `getAvailableLocationProviders()`: Enabled location providers
+
+**Display & Orientation** (3 APIs):
+
+- `isLandscape` → `getIsLandscape()`: Device orientation
+- `fontScale` → `getFontScale()`: System font scale multiplier
+- `brightness` → `getBrightness()`: Screen brightness (iOS only)
+
+**Migration Example**:
+
+```typescript
+// Before (v1.2.1)
+const level = DeviceInfoModule.batteryLevel;
+const charging = DeviceInfoModule.isBatteryCharging;
+
+// After (v1.3.0)
+const level = DeviceInfoModule.getBatteryLevel();
+const charging = DeviceInfoModule.getIsBatteryCharging();
+```
+
 ## [1.0.0] - 2025-10-25
 
 ### Added
@@ -38,6 +94,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 All methods listed below have been converted from Promise-based to synchronous for instant access (<1ms):
 
 **Device Identification** (2 methods):
+
 - `getUniqueId()`: `Promise<string>` → `string`
   - Returns device-unique ID (iOS: IDFV, Android: ANDROID_ID)
   - **Before**: `const id = await deviceInfo.getUniqueId()`
@@ -49,6 +106,7 @@ All methods listed below have been converted from Promise-based to synchronous f
   - **After**: `const manufacturer = deviceInfo.getManufacturer()`
 
 **Battery & Power** (3 methods):
+
 - `getBatteryLevel()`: `Promise<number>` → `number`
   - Returns battery level (0.0 to 1.0)
   - **Before**: `const level = await deviceInfo.getBatteryLevel()`
@@ -65,6 +123,7 @@ All methods listed below have been converted from Promise-based to synchronous f
   - **After**: `const state = deviceInfo.getPowerState()`
 
 **Application Metadata** (4 methods):
+
 - `getVersion()`: `Promise<string>` → `string`
   - Returns app version (e.g., "1.0.0")
   - **Before**: `const version = await deviceInfo.getVersion()`
@@ -86,6 +145,7 @@ All methods listed below have been converted from Promise-based to synchronous f
   - **After**: `const name = deviceInfo.getApplicationName()`
 
 **System Resources** (4 methods):
+
 - `getTotalMemory()`: `Promise<number>` → `number`
   - Returns total device RAM in bytes
   - **Before**: `const memory = await deviceInfo.getTotalMemory()`
@@ -107,6 +167,7 @@ All methods listed below have been converted from Promise-based to synchronous f
   - **After**: `const free = deviceInfo.getFreeDiskStorage()`
 
 **Device Capabilities** (3 methods):
+
 - `isCameraPresent()`: `Promise<boolean>` → `boolean`
   - Returns camera availability
   - **Before**: `const hasCamera = await deviceInfo.isCameraPresent()`
@@ -123,6 +184,7 @@ All methods listed below have been converted from Promise-based to synchronous f
   - **After**: `const isEmu = deviceInfo.isEmulator()`
 
 **Platform-Specific** (2 methods):
+
 - `getApiLevel()`: `Promise<number>` → `number`
   - Returns Android API level (or -1 on iOS)
   - **Before**: `const apiLevel = await deviceInfo.getApiLevel()`
@@ -154,6 +216,7 @@ All methods listed below have been converted from Promise-based to synchronous f
 #### Simplified Component Usage
 
 **Before (v0.1.0)**:
+
 ```typescript
 function MyComponent() {
   const [manufacturer, setManufacturer] = useState('');
@@ -183,6 +246,7 @@ function MyComponent() {
 ```
 
 **After (v1.0.0)**:
+
 ```typescript
 function MyComponent() {
   // Direct synchronous access - no useState, no useEffect, no async/await!

README-ko.md

@@ -66,7 +66,7 @@ console.log(manufacturer); // "Apple"
 const isTablet = DeviceInfoModule.isTablet;
 console.log(isTablet); // false
 
-const batteryLevel = DeviceInfoModule.batteryLevel;
+const batteryLevel = DeviceInfoModule.getBatteryLevel();
 console.log(`배터리: ${(batteryLevel * 100).toFixed(0)}%`); // "배터리: 85%"
 
 // 비동기 메서드 (Promise 기반 - <100ms)
@@ -97,9 +97,9 @@ const isEmulator = DeviceInfoModule.isEmulator; // false
 
 // 시스템 리소스
 const totalMemory = DeviceInfoModule.totalMemory;
-const usedMemory = DeviceInfoModule.usedMemory;
+const usedMemory = DeviceInfoModule.getUsedMemory();
 const totalDisk = DeviceInfoModule.totalDiskCapacity;
-const freeDisk = DeviceInfoModule.freeDiskStorage;
+const freeDisk = DeviceInfoModule.getFreeDiskStorage();
 
 console.log(
   `RAM: ${(usedMemory / 1024 / 1024).toFixed(0)}MB / ${(totalMemory / 1024 / 1024).toFixed(0)}MB`
@@ -109,9 +109,9 @@ console.log(
 );
 
 // 배터리 정보
-const batteryLevel = DeviceInfoModule.batteryLevel;
-const isCharging = DeviceInfoModule.isBatteryCharging;
-const powerState: PowerState = DeviceInfoModule.powerState;
+const batteryLevel = DeviceInfoModule.getBatteryLevel();
+const isCharging = DeviceInfoModule.getIsBatteryCharging();
+const powerState: PowerState = DeviceInfoModule.getPowerState();
 
 console.log(
   `배터리: ${(batteryLevel * 100).toFixed(0)}% ${isCharging ? '(충전 중)' : ''}`
@@ -164,7 +164,7 @@ DeviceInfoModule.model; // "iPhone"
 DeviceInfoModule.uniqueId; // 동기
 DeviceInfoModule.isTablet; // 동기
 DeviceInfoModule.totalMemory; // 동기
-DeviceInfoModule.batteryLevel; // 동기
+DeviceInfoModule.getBatteryLevel(); // 동기 메서드
 
 // 앱 정보
 DeviceInfoModule.version; // 동기
@@ -217,10 +217,10 @@ import { DeviceInfoModule } from 'react-native-nitro-device-info';
 const deviceId = DeviceInfoModule.deviceId; // 메서드가 아닌 속성
 const brand = DeviceInfoModule.brand; // 메서드가 아닌 속성
 
-// 대부분의 값이 이제 동기 속성
+// 대부분의 값이 이제 동기 속성 또는 메서드
 const uniqueId = DeviceInfoModule.uniqueId; // 속성, 동기!
 const totalMemory = DeviceInfoModule.totalMemory; // 속성, 동기!
-const batteryLevel = DeviceInfoModule.batteryLevel; // 속성, 동기!
+const batteryLevel = DeviceInfoModule.getBatteryLevel(); // 메서드, 동기!
 const isTablet = DeviceInfoModule.isTablet; // 속성, 동기!
 
 // 네트워크/연결만 비동기 메서드로 유지

README.md

@@ -65,7 +65,7 @@ console.log(manufacturer); // "Apple"
 const isTablet = DeviceInfoModule.isTablet;
 console.log(isTablet); // false
 
-const batteryLevel = DeviceInfoModule.batteryLevel;
+const batteryLevel = DeviceInfoModule.getBatteryLevel();
 console.log(`Battery: ${(batteryLevel * 100).toFixed(0)}%`); // "Battery: 85%"
 
 // Asynchronous methods (Promise-based - <100ms)
@@ -96,9 +96,9 @@ const isEmulator = DeviceInfoModule.isEmulator; // false
 
 // System Resources
 const totalMemory = DeviceInfoModule.totalMemory;
-const usedMemory = DeviceInfoModule.usedMemory;
+const usedMemory = DeviceInfoModule.getUsedMemory();
 const totalDisk = DeviceInfoModule.totalDiskCapacity;
-const freeDisk = DeviceInfoModule.freeDiskStorage;
+const freeDisk = DeviceInfoModule.getFreeDiskStorage();
 
 console.log(
   `RAM: ${(usedMemory / 1024 / 1024).toFixed(0)}MB / ${(totalMemory / 1024 / 1024).toFixed(0)}MB`
@@ -108,9 +108,9 @@ console.log(
 );
 
 // Battery Information
-const batteryLevel = DeviceInfoModule.batteryLevel;
-const isCharging = DeviceInfoModule.isBatteryCharging;
-const powerState: PowerState = DeviceInfoModule.powerState;
+const batteryLevel = DeviceInfoModule.getBatteryLevel();
+const isCharging = DeviceInfoModule.getIsBatteryCharging();
+const powerState: PowerState = DeviceInfoModule.getPowerState();
 
 console.log(
   `Battery: ${(batteryLevel * 100).toFixed(0)}% ${isCharging ? '(charging)' : ''}`
@@ -163,7 +163,7 @@ DeviceInfoModule.model; // "iPhone"
 DeviceInfoModule.uniqueId; // Sync
 DeviceInfoModule.isTablet; // Sync
 DeviceInfoModule.totalMemory; // Sync
-DeviceInfoModule.batteryLevel; // Sync
+DeviceInfoModule.getBatteryLevel(); // Sync method
 
 // App Info
 DeviceInfoModule.version; // Sync
@@ -216,10 +216,10 @@ import { DeviceInfoModule } from 'react-native-nitro-device-info';
 const deviceId = DeviceInfoModule.deviceId; // Property, not method
 const brand = DeviceInfoModule.brand; // Property, not method
 
-// Most values are now synchronous properties
+// Most values are now synchronous properties or methods
 const uniqueId = DeviceInfoModule.uniqueId; // Property, sync!
 const totalMemory = DeviceInfoModule.totalMemory; // Property, sync!
-const batteryLevel = DeviceInfoModule.batteryLevel; // Property, sync!
+const batteryLevel = DeviceInfoModule.getBatteryLevel(); // Method, sync!
 const isTablet = DeviceInfoModule.isTablet; // Property, sync!
 
 // Only network/connectivity remain async methods