docs: changelog

Author: l2hyunwoo

CHANGELOG.md

@@ -5,6 +5,52 @@ 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).
 
+## [1.4.0] - 2025-12-01
+
+### Added
+
+- **React Hooks for Device State Monitoring** ([#38](https://github.com/l2hyunwoo/react-native-nitro-device-info/pull/38)): 7 new React hooks for reactive device state monitoring
+
+  **Battery & Power** (3 hooks):
+  - `useBatteryLevel()`: Real-time battery level monitoring (0.0-1.0), polls every 5s
+  - `useBatteryLevelIsLow()`: Low battery detection with platform-specific thresholds (iOS: 20%, Android: 15%)
+  - `usePowerState()`: Comprehensive power state object with level, charging state, and low power mode
+
+  **Audio Output** (3 hooks):
+  - `useIsHeadphonesConnected()`: Any headphone connection monitoring, polls every 1s
+  - `useIsWiredHeadphonesConnected()`: Wired headphone detection, polls every 1s
+  - `useIsBluetoothHeadphonesConnected()`: Bluetooth audio device detection, polls every 1s
+
+  **Display** (1 hook):
+  - `useBrightness()`: Screen brightness monitoring (iOS only, returns -1 on Android), polls every 500ms
+
+- **Example App Enhancements**:
+  - Showcase app: Added HooksDemo screen with tab navigation for interactive hook demonstrations
+  - Benchmark app: Added React hooks performance benchmarks (registration time, cleanup validation, callback latency)
+
+- **Documentation**:
+  - New hooks API reference (`docs/api/hooks.md`) with complete signatures and platform support tables
+  - New React hooks usage guide (`docs/guide/react-hooks.md`) with 5+ examples
+  - Updated migration guide with hooks comparison table
+
+**Usage Example**:
+
+```typescript
+import { useBatteryLevel, useIsHeadphonesConnected } from 'react-native-nitro-device-info';
+
+function BatteryStatus() {
+  const batteryLevel = useBatteryLevel();
+  const isHeadphonesConnected = useIsHeadphonesConnected();
+
+  return (
+    <View>
+      <Text>Battery: {(batteryLevel * 100).toFixed(0)}%</Text>
+      <Text>Headphones: {isHeadphonesConnected ? 'Connected' : 'Disconnected'}</Text>
+    </View>
+  );
+}
+```
+
 ## [1.3.1] - 2025-12-01
 
 ### Fixed
@@ -304,5 +350,8 @@ The following methods remain Promise-based as they perform I/O operations:
 - iOS and Android native implementations
 - Example apps (showcase and benchmark)
 
-[1.0.0]: https://github.com/your-org/react-native-nitro-device-info/compare/v0.1.0...v1.0.0
-[0.1.0]: https://github.com/your-org/react-native-nitro-device-info/releases/tag/v0.1.0
+[1.4.0]: https://github.com/l2hyunwoo/react-native-nitro-device-info/compare/v1.3.1...v1.4.0
+[1.3.1]: https://github.com/l2hyunwoo/react-native-nitro-device-info/compare/v1.3.0...v1.3.1
+[1.3.0]: https://github.com/l2hyunwoo/react-native-nitro-device-info/compare/v1.0.0...v1.3.0
+[1.0.0]: https://github.com/l2hyunwoo/react-native-nitro-device-info/compare/v0.1.0...v1.0.0
+[0.1.0]: https://github.com/l2hyunwoo/react-native-nitro-device-info/releases/tag/v0.1.0