Release: accessibility improvements and documentation updates (#834)

* docs: update homepage field of package.json

* docs: add comprehensive programmatic control documentation (#833)

- Add new 'Programmatic Control' page with detailed API reference
- Include practical examples for pagination, navigation, dynamic content
- Clarify difference between controlled components and imperative API
- Update migration guide to use correct terminology
- Add warnings about race conditions and timing considerations

Fixes #822

* feat: add accessibility support to pagination components (#832)

- Add comprehensive a11y props to Basic and Custom pagination components
- Add carouselName prop for descriptive accessibility labels
- Replace TouchableWithoutFeedback with Pressable
- Improve screen reader support with proper labeling

Co-authored-by: AlexJackson01 <[email protected]>

* fix: replace TouchableWithoutFeedback with Pressable in pagination (#831)

- Replace deprecated TouchableWithoutFeedback with Pressable in Basic PaginationItem
- Replace deprecated TouchableWithoutFeedback with Pressable in Custom PaginationItem
- Maintains same functionality while using modern React Native API
- Removes deprecation warnings

Closes #812

* fix: correct TypeScript syntax in useCarouselController test

Fix ReturnType<typeof useSharedValue<number>> to ReturnType<typeof useSharedValue>
to resolve build error

---------

Co-authored-by: AlexJackson01 <[email protected]>

Author: dohooo

.changeset/add-pagination-accessibility.md

@@ -0,0 +1,12 @@
+---
+"react-native-reanimated-carousel": patch
+---
+
+Add accessibility support to pagination components and replace deprecated TouchableWithoutFeedback with Pressable
+
+- Add comprehensive accessibility props (accessibilityLabel, accessibilityRole, accessibilityHint, accessibilityState) to both Basic and Custom pagination components
+- Add carouselName prop to allow descriptive accessibility labels
+- Replace TouchableWithoutFeedback with Pressable to remove deprecation warnings
+- Improve screen reader support with proper labeling and state information
+
+Co-authored-by: AlexJackson01 <[email protected]>

.changeset/add-programmatic-control-docs.md

@@ -0,0 +1,11 @@
+---
+"react-native-reanimated-carousel": patch
+---
+
+Add comprehensive programmatic control documentation
+
+- Add new "Programmatic Control" documentation page with detailed examples
+- Clarify that there's no React-style controlled component mode
+- Update migration guide to use correct terminology and link to new docs
+- Provide examples for common use cases: pagination, navigation buttons, dynamic content, auto-advance, and jump-to-item patterns
+- Include warnings about race conditions and timing considerations

.changeset/fix-touchable-deprecation.md

@@ -0,0 +1,9 @@
+---
+"react-native-reanimated-carousel": patch
+---
+
+Replace deprecated TouchableWithoutFeedback with Pressable in pagination components
+
+Fixes deprecation warnings by replacing TouchableWithoutFeedback with the recommended Pressable component in both Basic and Custom pagination items. This change maintains the same functionality while using the modern React Native API.
+
+Closes #812

.changeset/shy-walls-clap.md

@@ -0,0 +1,5 @@
+---
+"react-native-reanimated-carousel": patch
+---
+
+Update homepage in package.json

example/website/pages/_meta.json

@@ -2,6 +2,7 @@
   "index": "Getting Started",
   "props": "Props",
   "usage": "Usage",
+  "programmatic-control": "Programmatic Control",
   "Examples": "Examples",
   "custom-animations": "Custom Animations",
   "concepts": "How it works?",

example/website/pages/migration-v4.mdx

@@ -226,10 +226,15 @@ The `defaultIndex` prop behavior has changed:
 <Carousel defaultIndex={index} />
 
 // After (v4.x) - subsequent defaultIndex changes are ignored
-// Use controlled mode if you need to programmatically change the index
+// Use programmatic control if you need to change the index after mount
 <Carousel 
   defaultIndex={index} // Only initial value is considered
+  ref={carouselRef}
 />
+
+// To change index programmatically, use the ref:
+// carouselRef.current?.scrollTo({ index: newIndex, animated: true })
+// See: /programmatic-control for detailed examples
 ```
 
 ## Migration Steps