docs: add CHANGELOG.md and update contribution guidelines

Author: lodev09

.github/PULL_REQUEST_TEMPLATE.md

@@ -23,3 +23,4 @@
 - [ ] I tested on Android
 - [ ] I tested on Web
 - [ ] I updated the documentation (if needed)
+- [ ] I added a changelog entry (if needed)

AGENTS.md

@@ -91,4 +91,16 @@ When creating a PR, use the template from `.github/PULL_REQUEST_TEMPLATE.md`:
 2. **Type of Change** - Select one: Bug fix, New feature, Breaking change, or Documentation update
 3. **Test Plan** - Explain how the changes were tested
 4. **Screenshots / Videos** - Include if applicable
-5. **Checklist** - Mark platforms tested (iOS, Android, Web) and documentation updates
+5. **Checklist** - Mark platforms tested (iOS, Android, Web), documentation and changelog updates
+
+#### Changelog
+
+Add entry to `Unpublished` section in `CHANGELOG.md` for user-facing changes:
+
+- `🎉 New features` - New functionality
+- `🐛 Bug fixes` - Bug fixes
+- `💡 Others` - Refactors, internal changes
+
+Format: `- **Platform**: Description. ([#123](https://github.com/lodev09/react-native-true-sheet/pull/123))`
+
+When creating release notes, move entries from `Unpublished` to a new version section.

CHANGELOG.md

@@ -0,0 +1,245 @@
+# Changelog
+
+## Unpublished
+
+### 🎉 New features
+
+- Added `dismissAll` static method. ([#393](https://github.com/lodev09/react-native-true-sheet/pull/393))
+
+### 🐛 Bug fixes
+
+- **Android**: Fixed keyboard and focus handling inside RN Modal. ([#387](https://github.com/lodev09/react-native-true-sheet/pull/387))
+
+## 3.7.0
+
+### 🐛 Bug fixes
+
+- **Android**: Fixed keyboard dismiss when presenting at dimmed detent.
+- Improved keyboard handling for sheet presentation. ([#379](https://github.com/lodev09/react-native-true-sheet/pull/379))
+- **Android**: Fixed `pointerEvents` not being respected in TrueSheetFooterView.
+- **Android**: Added `pointerEvents` prop support to view managers.
+- **Android**: Added RootNodeKind trait for nested sheet touch handling. ([#375](https://github.com/lodev09/react-native-true-sheet/pull/375))
+- **Android**: Fixed coordinator layout remeasure on configuration change.
+- **Android**: Fixed footer repositioning when keyboard hides via IME action button.
+
+## 3.6.11
+
+### 🐛 Bug fixes
+
+- **Android**: Fixed eventDispatcher propagation via delegate chain for footer touch handling. ([#372](https://github.com/lodev09/react-native-true-sheet/pull/372))
+
+## 3.6.10
+
+### 🐛 Bug fixes
+
+- **Android**: Fixed sheet drag when ScrollView cannot scroll. ([#369](https://github.com/lodev09/react-native-true-sheet/pull/369))
+
+## 3.6.9
+
+### 🐛 Bug fixes
+
+- **Android**: Fixed keyboard handling to only apply for focused views within sheet. ([#365](https://github.com/lodev09/react-native-true-sheet/pull/365))
+- **Android**: Fixed sheet dismissing early when container is unmounted.
+- **iOS**: Fixed sheets dismissing properly during navigation and reload.
+
+## 3.6.8
+
+### 🐛 Bug fixes
+
+- **iOS**: Fixed keyboard offset preservation when footer resizes. ([#361](https://github.com/lodev09/react-native-true-sheet/pull/361))
+- **Android**: Optimized findRootContainerView to return first content view.
+- **Android**: Fixed TrueSheet rendering above React Native Modal. ([#359](https://github.com/lodev09/react-native-true-sheet/pull/359))
+
+## 3.6.7
+
+### 🐛 Bug fixes
+
+- Fixed initial present flag reset during recycle.
+
+## 3.6.6
+
+### 🐛 Bug fixes
+
+- **Android**: Fixed setupModalObserver to present lifecycle.
+
+### 💡 Others
+
+- Simplified initial presentation to only trigger on attach to window.
+
+## 3.6.5
+
+### 🐛 Bug fixes
+
+- **Android**: Fixed animated sheet dismiss with keyboard shown.
+
+## 3.6.4
+
+### 🐛 Bug fixes
+
+- **Android**: Fixed initial presentation to wait for window attachment.
+
+## 3.6.3
+
+### 🐛 Bug fixes
+
+- **iOS**: Added compile-time check for iOS 26.1+ APIs.
+- **Android**: Added safe value for halfExpandedRatio.
+
+## 3.6.2
+
+### 🐛 Bug fixes
+
+- **iOS**: Fixed blur intensity with backgroundBlur on iOS 26.1+.
+
+## 3.6.1
+
+### 🐛 Bug fixes
+
+- **iOS**: Fixed fallback to view.backgroundColor when UIDesignRequiresCompatibility is true.
+
+## 3.6.0
+
+### 🎉 New features
+
+- Added `elevation` prop for Android and Web. ([#355](https://github.com/lodev09/react-native-true-sheet/pull/355))
+
+### 🐛 Bug fixes
+
+- **Android**: Fixed keyboard dismiss issue with backdrop. ([#351](https://github.com/lodev09/react-native-true-sheet/pull/351))
+- **iOS**: Fixed native backgroundEffect for blur on iOS 26.1+. ([#350](https://github.com/lodev09/react-native-true-sheet/pull/350))
+
+## 3.5.8
+
+### 🎉 New features
+
+- Added `headerStyle` and `footerStyle` props.
+
+## 3.5.7
+
+### 🐛 Bug fixes
+
+- **Web**: Fixed pointerEvents on footer container.
+
+## 3.5.6
+
+### 🎉 New features
+
+- **Web**: Added 'none' option to `stackBehavior` prop.
+- **Web**: Added shadow for web sheet.
+
+## 3.5.5
+
+### 🐛 Bug fixes
+
+- Fixed pointerEvents on header, footer and host view.
+
+## 3.5.4
+
+### 🐛 Bug fixes
+
+- **iOS**: Fixed initial presentation to defer until view is in window hierarchy.
+
+## 3.5.3
+
+### 🐛 Bug fixes
+
+- **iOS**: Fixed TrueSheetView being included in scroll view pinning traversal.
+
+## 3.5.2
+
+### 🐛 Bug fixes
+
+- **Android**: Fixed sheet showing briefly when navigating within a stack.
+
+## 3.5.1
+
+### 🐛 Bug fixes
+
+- **Android**: Fixed parent stacking after rn-screen dismissed.
+- **Android**: Fixed dragging on parent sheet when child is stacked.
+- **Android**: Improved dim tap handling for stacked sheets.
+- **Android**: Fixed collapse to lowest detent on back press when non-dismissible.
+- **Android**: Fixed sheet fade before hiding when rn-screen modal shows.
+- **Android**: Fixed content clipping to rounded corners on older API levels.
+- **Android**: Fixed collapse to lowest detent on dim tap when non-dismissible.
+- **Android**: Fixed bottom sheet centering horizontally on rotation.
+- **Android**: Fixed sheet from reshowing when returning from background with rn-screens.
+- **Android**: Fixed dismiss animation on back button press.
+- **Android**: Fixed footer positioning using onSlide for API < 30.
+- **Android**: Fixed grabber hitbox causing touch issues.
+- **Android**: Fixed sheet position during non-animated present.
+- **Android**: Fixed stacked sheet translation on dismiss.
+- **Android**: Fixed translation on initialDetentIndex present.
+- **Android**: Fixed initial present on older android versions.
+- **Android**: Fixed halfExpandedRatio to be between 0 and 1.
+
+### 💡 Others
+
+- **Android**: Replaced DialogFragment with CoordinatorLayout. ([#344](https://github.com/lodev09/react-native-true-sheet/pull/344))
+- **Android**: Refactored to use BottomSheetDialogFragment. ([#342](https://github.com/lodev09/react-native-true-sheet/pull/342))
+
+## 3.5.0
+
+### 🎉 New features
+
+- **Android**: Improved transition animations and refactored detent calculations. ([#337](https://github.com/lodev09/react-native-true-sheet/pull/337))
+
+### 🐛 Bug fixes
+
+- **Android**: Fixed sheet stack restoration when modal dismisses.
+- **Android**: Fixed dim view alpha animation when restoring from modal.
+- **Android**: Improved keyboard handling and detent restoration.
+- **Android**: Fixed target keyboard height for detent calculations.
+- **Android**: Fixed window visibility to prevent keyboard non-focus issue.
+
+## 3.4.2
+
+### 🐛 Bug fixes
+
+- **Android**: Fixed sheet from showing when app returns from background.
+
+## 3.4.1
+
+### 🎉 New features
+
+- **iOS**: Added default blur tint for iOS < 26. ([#334](https://github.com/lodev09/react-native-true-sheet/pull/334))
+
+## 3.4.0
+
+### 🎉 New features
+
+- **Android**: Added custom dim view with smooth interpolation. ([#327](https://github.com/lodev09/react-native-true-sheet/pull/327))
+- **Android**: Added parent translation updates when child sheet size changes.
+
+### 🐛 Bug fixes
+
+- **Android**: Fixed flashing footer during initial present.
+- **Android**: Fixed dim view hiding when RN Screen is presented.
+
+### 💡 Others
+
+- Refactored mocks to export per module. ([#329](https://github.com/lodev09/react-native-true-sheet/pull/329))
+
+## 3.3.5
+
+### 🐛 Bug fixes
+
+- **Android**: Fixed grabber shadow by using bringToFront instead of elevation.
+
+## 3.3.4
+
+### 🎉 New features
+
+- Added adaptive grabber color for light/dark mode. ([#325](https://github.com/lodev09/react-native-true-sheet/pull/325))
+
+## 3.3.3
+
+### 🐛 Bug fixes
+
+- Fixed key window fallback for cold start and deep link handling. ([#323](https://github.com/lodev09/react-native-true-sheet/pull/323))
+
+## 3.3.2
+
+### 🐛 Bug fixes
+
+- Fixed batch dismiss behavior for stacked sheets. ([#322](https://github.com/lodev09/react-native-true-sheet/pull/322))

CONTRIBUTING.md

@@ -148,3 +148,4 @@ When you're sending a pull request:
 - Review the documentation to make sure it looks good.
 - Follow the pull request template when opening a pull request.
 - For pull requests that change the API or implementation, discuss with maintainers first by opening an issue.
+- Add a changelog entry to the `Unpublished` section in [CHANGELOG.md](./CHANGELOG.md) for any user-facing changes.