expo-tvos-search 1.2.0 → 1.2.3

package/README.md

@@ -1,8 +1,10 @@
 # expo-tvos-search
 
-A native tvOS search component for Expo and React Native.
+[![npm version](https://img.shields.io/npm/v/expo-tvos-search.svg)](https://www.npmjs.com/package/expo-tvos-search)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Test Status](https://github.com/keiver/expo-tvos-search/workflows/Test%20PR/badge.svg)](https://github.com/keiver/expo-tvos-search/actions)
 
-This library provides a native tvOS search view using SwiftUI's `.searchable` modifier. It handles focus, keyboard navigation, and accessibility out of the box, providing a seamless search experience on Apple TV with a native fullscreen search interface.
+A native tvOS search component for Expo and React Native using SwiftUI's `.searchable` modifier. Handles focus, keyboard navigation, and accessibility out of the box.
 
 <p align="center">
   <img src="screenshots/results.png" width="700" alt="TomoTV Search Results"/>
@@ -29,7 +31,13 @@ This library provides a native tvOS search view using SwiftUI's `.searchable` mo
 ## Installation
 
 ```bash
-npm install github:keiver/expo-tvos-search
+npx expo install expo-tvos-search
+```
+
+Or install from GitHub:
+
+```bash
+npx expo install github:keiver/expo-tvos-search
 ```
 
 Then rebuild your native project:
@@ -92,6 +100,10 @@ function SearchScreen() {
 | `showTitleOverlay` | `boolean` | `true` | Show title overlay with gradient at bottom of card |
 | `enableMarquee` | `boolean` | `true` | Enable marquee scrolling for long titles |
 | `marqueeDelay` | `number` | `1.5` | Delay in seconds before marquee starts |
+| `emptyStateText` | `string` | `"Search for movies and videos"` | Text shown when search field is empty |
+| `searchingText` | `string` | `"Searching..."` | Text shown during search |
+| `noResultsText` | `string` | `"No results found"` | Text shown when no results found |
+| `noResultsHintText` | `string` | `"Try a different search term"` | Hint text below no results message |
 | `onSearch` | `function` | required | Called when search text changes |
 | `onSelectItem` | `function` | required | Called when result is selected |
 
@@ -106,8 +118,18 @@ interface SearchResult {
 }
 ```
 
+## Result Handling
+
+The native implementation applies the following validation and constraints:
+
+- **Maximum results**: The results array is capped at 500 items. Any results beyond this limit are silently ignored.
+- **Required fields**: Results with empty `id` or `title` are automatically filtered out and not displayed.
+- **Image URL schemes**: Only HTTP and HTTPS URLs are accepted for `imageUrl`. Other URL schemes (e.g., `file://`, `data:`) are rejected.
+- **HTTPS recommended**: HTTP URLs may be blocked by App Transport Security on tvOS unless explicitly allowed in Info.plist.
+
 ## Requirements
 
+- Node.js 18.0+
 - Expo SDK 51+
 - tvOS 15.0+
 - React Native TVOS
@@ -127,7 +149,7 @@ npx expo run:ios
 ### Images not loading
 
 1. Verify your image URLs are HTTPS (HTTP may be blocked by App Transport Security)
-2. Check that the Jellyfin API key is included in the URL query parameters
+2. Ensure required authentication parameters are included in image URLs
 3. For local development, ensure your server is accessible from the Apple TV
 
 ### Focus issues
@@ -161,37 +183,6 @@ Tests cover:
 - Component rendering when native module is unavailable
 - Event structure validation
 
-### Best Practices
-
-For optimal performance:
-- **Debounce search input**: Wait 300-500ms after typing stops before calling your API
-- **Batch result updates**: Update the entire `results` array at once rather than incrementally
-- **Limit image sizes**: Use appropriately sized poster images (280x420 is the card size)
-- **Cap result count**: Consider limiting to 50-100 results for smooth scrolling
-
-## Accessibility
-
-### Built-in Support
-
-The native SwiftUI implementation provides accessibility features automatically:
-- **Focus management**: tvOS focus system handles navigation
-- **VoiceOver**: Cards announce title and subtitle
-- **Button semantics**: Cards are properly identified as interactive elements
-- **Focus indicators**: Visual feedback for focused state
-
-### Remote Navigation
-
-The native `.searchable` modifier provides standard tvOS navigation:
-- **Swipe up/down**: Move between search field and results
-- **Swipe left/right**: Navigate between grid items
-- **Click (select)**: Open the focused result
-- **Menu button**: Exit search or navigate back
-
-Built for [TomoTV](https://github.com/keiver/tomotv), a Jellyfin client for Apple TV.
-
-Swift documentation references:
-- [.searchable modifier](https://developer.apple.com/documentation/SwiftUI/Creating-a-tvOS-media-catalog-app-in-SwiftUI)
-
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-tvos-search",
-  "version": "1.2.0",
+  "version": "1.2.3",
   "description": "Native tvOS search view using SwiftUI .searchable modifier for Expo/React Native",
   "main": "build/index.js",
   "types": "build/index.d.ts",