YPE-1156: Hooks - Deprecate Unused Hooks

.changeset/twenty-onions-wish.md

@@ -0,0 +1,13 @@
+---
+'@youversion/platform-react-hooks': minor
+'@youversion/platform-core': minor
+'@youversion/platform-react-ui': minor
+---
+
+Deprecates hooks and providers that are not used by the UI package or any known consumers. These were inherited from a hackathon project and never adopted. These will be fully removed in the next major version bump.
+
+Deprecated:
+- `useInitData` — convenience wrapper over `useVersion`, `useBook`, `useChapter` that loses error granularity, drops `refetch`, and has zero consumers. Use the three hooks directly.
+- `useChapterNavigation` — coupled to `ReaderProvider` which nobody uses. The UI package calls `getAdjacentChapter` from core directly.
+- `ReaderProvider`, `ReaderContext`, `useReaderContext` — the UI package built its own `BibleReaderContext` instead. Zero consumers.
+- `VerseSelectionProvider`, `VerseSelectionContext`, `useVerseSelection` — the UI package handles verse selection via props/callbacks. Zero consumers.

greptile.json

@@ -16,7 +16,7 @@
         "rule": "Schema-first: All types defined in schemas/*.ts using Zod"
       },
       {
-        "scope": ["packages/**"],
+        "scope": ["packages/**", ".changeset/**"],
         "rule": "Unified versioning: All packages must maintain exact same version - never version packages independently"
       },
       {

packages/hooks/AGENTS.md

@@ -1,7 +1,7 @@
 # @youversion/platform-react-hooks
 
 ## OVERVIEW
-React integration layer providing data fetching hooks with 3 core providers: YouVersionProvider, YouVersionAuthProvider, and ReaderProvider.
+React integration layer providing data fetching hooks with 2 core providers: YouVersionProvider and YouVersionAuthProvider.
 
 **Depends on `@youversion/platform-core` for all API calls.** Hooks delegate to core clients; do not implement raw HTTP here.
 
@@ -15,12 +15,12 @@ React integration layer providing data fetching hooks with 3 core providers: You
 - `utility/` - Helper functions (useDebounce, extractTextFromHTML, extractVersesFromHTML)
 
 ## PUBLIC API
-- Data fetching hooks: useBook, useChapter, usePassage, useVersion, useVOTD, useVerse, useChapterNavigation, etc.
+- Data fetching hooks: useBook, useChapter, usePassage, useVersion, useVOTD, useVerse, etc.
 - YouVersionProvider - Core SDK configuration
 - YouVersionAuthProvider - Authentication state
-- ReaderProvider - Reading session context
 - Utility functions exported from utility/index
 
+
 ## PROVIDERS
 
 - **YouVersionProvider**
@@ -31,10 +31,6 @@ React integration layer providing data fetching hooks with 3 core providers: You
   - Manages authentication state (userInfo, tokens, isLoading, error)
   - Auth hooks like `useYVAuth` depend on this provider
 
-- **ReaderProvider**
-  - Manages Bible reading session state (currentVersion, currentChapter, currentBook, currentVerse)
-  - Hooks like `useChapterNavigation` depend on this provider
-
 ## DOs / DON'Ts
 
 ✅ Do: Use `YouVersionProvider` for configuration and access that config in hooks

packages/hooks/src/context/ReaderContext.tsx

@@ -14,8 +14,14 @@ type ReaderContextData = {
   setVerse: (verse: BibleVerse | null) => void;
 };
 
+/**
+ * @deprecated No replacement needed. Remove usage. Will be removed in the next major version.
+ */
 export const ReaderContext = createContext<ReaderContextData | null>(null);
 
+/**
+ * @deprecated No replacement needed. Remove usage. Will be removed in the next major version.
+ */
 export function useReaderContext(): ReaderContextData {
   const context = useContext(ReaderContext);