@youversion/platform-react-hooks 1.11.0 → 1.12.0

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @youversion/platform-react-hooks@1.11.0 build /home/runner/work/platform-sdk-react/platform-sdk-react/packages/hooks
+> @youversion/platform-react-hooks@1.12.0 build /home/runner/work/platform-sdk-react/platform-sdk-react/packages/hooks
 > tsc -p tsconfig.build.json
 

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @youversion/platform-react-hooks
 
+## 1.12.0
+
+### Minor Changes
+
+- 1bafe50: Add all_available and fields parameters to getVersions api call in core package and useVersions in hooks package.
+
+### Patch Changes
+
+- Updated dependencies [1bafe50]
+  - @youversion/platform-core@1.12.0
+
 ## 1.11.0
 
 ### Minor Changes

package/dist/__tests__/mocks/bibles.d.ts

@@ -0,0 +1,22 @@
+import type { BibleBook, BibleChapter, BibleVerse, BibleVersion } from '@youversion/platform-core';
+/**
+ * Creates a mock Bible version for testing
+ * @param overrides Optional properties to override defaults
+ */
+export declare const createMockVersion: (overrides?: Partial<BibleVersion>) => BibleVersion;
+/**
+ * Creates a mock Bible book for testing
+ * @param overrides Optional properties to override defaults
+ */
+export declare const createMockBook: (overrides?: Partial<BibleBook>) => BibleBook;
+/**
+ * Creates a mock Bible chapter for testing
+ * @param overrides Optional properties to override defaults
+ */
+export declare const createMockChapter: (overrides?: Partial<BibleChapter>) => BibleChapter;
+/**
+ * Creates a mock Bible verse for testing
+ * @param overrides Optional properties to override defaults
+ */
+export declare const createMockVerse: (overrides?: Partial<BibleVerse>) => BibleVerse;
+//# sourceMappingURL=bibles.d.ts.map

package/dist/__tests__/mocks/bibles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bibles.d.ts","sourceRoot":"","sources":["../../../src/__tests__/mocks/bibles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEnG;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,YAAY,OAAO,CAAC,YAAY,CAAC,KAAG,YAcpE,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,YAAY,OAAO,CAAC,SAAS,CAAC,KAAG,SAO9D,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,YAAY,OAAO,CAAC,YAAY,CAAC,KAAG,YAKpE,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,YAAY,OAAO,CAAC,UAAU,CAAC,KAAG,UAKhE,CAAC"}

package/dist/__tests__/mocks/bibles.js

@@ -0,0 +1,52 @@
+/**
+ * Creates a mock Bible version for testing
+ * @param overrides Optional properties to override defaults
+ */
+export const createMockVersion = (overrides) => ({
+    id: 1,
+    title: 'King James Version',
+    abbreviation: 'KJV',
+    copyright: '',
+    promotional_content: '',
+    info: null,
+    publisher_url: null,
+    language_tag: 'en',
+    localized_abbreviation: 'KJV',
+    localized_title: 'King James Version',
+    books: [],
+    youversion_deep_link: 'https://www.bible.com/versions/1',
+    ...overrides,
+});
+/**
+ * Creates a mock Bible book for testing
+ * @param overrides Optional properties to override defaults
+ */
+export const createMockBook = (overrides) => ({
+    id: 'GEN',
+    title: 'Genesis',
+    full_title: 'The First Book of Moses, Commonly Called Genesis',
+    abbreviation: 'Gen',
+    canon: 'old_testament',
+    ...overrides,
+});
+/**
+ * Creates a mock Bible chapter for testing
+ * @param overrides Optional properties to override defaults
+ */
+export const createMockChapter = (overrides) => ({
+    id: '1',
+    passage_id: 'GEN.1',
+    title: '1',
+    ...overrides,
+});
+/**
+ * Creates a mock Bible verse for testing
+ * @param overrides Optional properties to override defaults
+ */
+export const createMockVerse = (overrides) => ({
+    id: '1',
+    passage_id: 'GEN.1.1',
+    title: '1',
+    ...overrides,
+});
+//# sourceMappingURL=bibles.js.map

package/dist/__tests__/mocks/bibles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bibles.js","sourceRoot":"","sources":["../../../src/__tests__/mocks/bibles.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAiC,EAAgB,EAAE,CAAC,CAAC;IACrF,EAAE,EAAE,CAAC;IACL,KAAK,EAAE,oBAAoB;IAC3B,YAAY,EAAE,KAAK;IACnB,SAAS,EAAE,EAAE;IACb,mBAAmB,EAAE,EAAE;IACvB,IAAI,EAAE,IAAI;IACV,aAAa,EAAE,IAAI;IACnB,YAAY,EAAE,IAAI;IAClB,sBAAsB,EAAE,KAAK;IAC7B,eAAe,EAAE,oBAAoB;IACrC,KAAK,EAAE,EAAE;IACT,oBAAoB,EAAE,kCAAkC;IACxD,GAAG,SAAS;CACb,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAA8B,EAAa,EAAE,CAAC,CAAC;IAC5E,EAAE,EAAE,KAAK;IACT,KAAK,EAAE,SAAS;IAChB,UAAU,EAAE,kDAAkD;IAC9D,YAAY,EAAE,KAAK;IACnB,KAAK,EAAE,eAAe;IACtB,GAAG,SAAS;CACb,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAiC,EAAgB,EAAE,CAAC,CAAC;IACrF,EAAE,EAAE,GAAG;IACP,UAAU,EAAE,OAAO;IACnB,KAAK,EAAE,GAAG;IACV,GAAG,SAAS;CACb,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,SAA+B,EAAc,EAAE,CAAC,CAAC;IAC/E,EAAE,EAAE,GAAG;IACP,UAAU,EAAE,SAAS;IACrB,KAAK,EAAE,GAAG;IACV,GAAG,SAAS;CACb,CAAC,CAAC"}

package/dist/useVersions.d.ts

@@ -1,6 +1,16 @@
 import { type UseApiDataOptions } from './useApiData';
 import type { Collection, BibleVersion } from '@youversion/platform-core';
-export declare function useVersions(languageRanges?: string, licenseId?: string | number, options?: UseApiDataOptions): {
+export interface UseVersionsOptions extends UseApiDataOptions {
+    /** Maximum number of results per page, or '*' for all (requires 1-3 fields) */
+    page_size?: number | '*';
+    /** Token for pagination */
+    page_token?: string;
+    /** Specific fields to return (required when page_size is '*', must be 1-3 fields) */
+    fields?: (keyof BibleVersion)[];
+    /** Include all available versions regardless of license */
+    all_available?: boolean;
+}
+export declare function useVersions(languageRanges?: string | string[], licenseId?: string | number, options?: UseVersionsOptions): {
     versions: Collection<BibleVersion> | null;
     loading: boolean;
     error: Error | null;

package/dist/useVersions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useVersions.d.ts","sourceRoot":"","sources":["../src/useVersions.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE1E,wBAAgB,WAAW,CACzB,cAAc,GAAE,MAAa,EAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAC3B,OAAO,CAAC,EAAE,iBAAiB,GAC1B;IACD,QAAQ,EAAE,UAAU,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAiBA"}
+{"version":3,"file":"useVersions.d.ts","sourceRoot":"","sources":["../src/useVersions.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE1E,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IACzB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,MAAM,CAAC,EAAE,CAAC,MAAM,YAAY,CAAC,EAAE,CAAC;IAChC,2DAA2D;IAC3D,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,WAAW,CACzB,cAAc,GAAE,MAAM,GAAG,MAAM,EAAS,EACxC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAC3B,OAAO,CAAC,EAAE,kBAAkB,GAC3B;IACD,QAAQ,EAAE,UAAU,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CA4CA"}

package/dist/useVersions.js

@@ -3,7 +3,31 @@ import { useBibleClient } from './useBibleClient';
 import { useApiData } from './useApiData';
 export function useVersions(languageRanges = 'en', licenseId, options) {
     const bibleClient = useBibleClient();
-    const { data: versions, loading, error, refetch, } = useApiData(() => bibleClient.getVersions(languageRanges, licenseId), [bibleClient, languageRanges, licenseId], {
+    const getVersionsOptions = options?.page_size !== undefined ||
+        options?.page_token !== undefined ||
+        options?.fields !== undefined ||
+        options?.all_available !== undefined
+        ? {
+            page_size: options?.page_size,
+            page_token: options?.page_token,
+            fields: options?.fields,
+            all_available: options?.all_available,
+        }
+        : undefined;
+    // Create stable keys for arrays to avoid unnecessary refetches
+    const languageRangesKey = Array.isArray(languageRanges)
+        ? languageRanges.join(',')
+        : languageRanges;
+    const fieldsKey = options?.fields?.join(',');
+    const { data: versions, loading, error, refetch, } = useApiData(() => bibleClient.getVersions(languageRanges, licenseId, getVersionsOptions), [
+        bibleClient,
+        languageRangesKey,
+        licenseId,
+        options?.page_size,
+        options?.page_token,
+        fieldsKey,
+        options?.all_available,
+    ], {
         enabled: options?.enabled !== false,
     });
     return { versions, loading, error, refetch };

package/dist/useVersions.js.map

@@ -1 +1 @@
-{"version":3,"file":"useVersions.js","sourceRoot":"","sources":["../src/useVersions.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAA0B,MAAM,cAAc,CAAC;AAGlE,MAAM,UAAU,WAAW,CACzB,iBAAyB,IAAI,EAC7B,SAA2B,EAC3B,OAA2B;IAO3B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,MAAM,EACJ,IAAI,EAAE,QAAQ,EACd,OAAO,EACP,KAAK,EACL,OAAO,GACR,GAAG,UAAU,CACZ,GAAG,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,cAAc,EAAE,SAAS,CAAC,EACxD,CAAC,WAAW,EAAE,cAAc,EAAE,SAAS,CAAC,EACxC;QACE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,KAAK;KACpC,CACF,CAAC;IAEF,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"useVersions.js","sourceRoot":"","sources":["../src/useVersions.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAA0B,MAAM,cAAc,CAAC;AAclE,MAAM,UAAU,WAAW,CACzB,iBAAoC,IAAI,EACxC,SAA2B,EAC3B,OAA4B;IAO5B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,MAAM,kBAAkB,GACtB,OAAO,EAAE,SAAS,KAAK,SAAS;QAChC,OAAO,EAAE,UAAU,KAAK,SAAS;QACjC,OAAO,EAAE,MAAM,KAAK,SAAS;QAC7B,OAAO,EAAE,aAAa,KAAK,SAAS;QAClC,CAAC,CAAC;YACE,SAAS,EAAE,OAAO,EAAE,SAAS;YAC7B,UAAU,EAAE,OAAO,EAAE,UAAU;YAC/B,MAAM,EAAE,OAAO,EAAE,MAAM;YACvB,aAAa,EAAE,OAAO,EAAE,aAAa;SACtC;QACH,CAAC,CAAC,SAAS,CAAC;IAEhB,+DAA+D;IAC/D,MAAM,iBAAiB,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC;QACrD,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC;QAC1B,CAAC,CAAC,cAAc,CAAC;IACnB,MAAM,SAAS,GAAG,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAE7C,MAAM,EACJ,IAAI,EAAE,QAAQ,EACd,OAAO,EACP,KAAK,EACL,OAAO,GACR,GAAG,UAAU,CACZ,GAAG,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,cAAc,EAAE,SAAS,EAAE,kBAAkB,CAAC,EAC5E;QACE,WAAW;QACX,iBAAiB;QACjB,SAAS;QACT,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,UAAU;QACnB,SAAS;QACT,OAAO,EAAE,aAAa;KACvB,EACD;QACE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,KAAK;KACpC,CACF,CAAC;IAEF,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC/C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youversion/platform-react-hooks",
-  "version": "1.11.0",
+  "version": "1.12.0",
   "type": "module",
   "publishConfig": {
     "access": "public",
@@ -22,7 +22,7 @@
     }
   },
   "dependencies": {
-    "@youversion/platform-core": "1.11.0"
+    "@youversion/platform-core": "1.12.0"
   },
   "peerDependencies": {
     "react": ">=19.1.0 <20.0.0"

package/src/__tests__/mocks/bibles.ts

@@ -0,0 +1,56 @@
+import type { BibleBook, BibleChapter, BibleVerse, BibleVersion } from '@youversion/platform-core';
+
+/**
+ * Creates a mock Bible version for testing
+ * @param overrides Optional properties to override defaults
+ */
+export const createMockVersion = (overrides?: Partial<BibleVersion>): BibleVersion => ({
+  id: 1,
+  title: 'King James Version',
+  abbreviation: 'KJV',
+  copyright: '',
+  promotional_content: '',
+  info: null,
+  publisher_url: null,
+  language_tag: 'en',
+  localized_abbreviation: 'KJV',
+  localized_title: 'King James Version',
+  books: [],
+  youversion_deep_link: 'https://www.bible.com/versions/1',
+  ...overrides,
+});
+
+/**
+ * Creates a mock Bible book for testing
+ * @param overrides Optional properties to override defaults
+ */
+export const createMockBook = (overrides?: Partial<BibleBook>): BibleBook => ({
+  id: 'GEN',
+  title: 'Genesis',
+  full_title: 'The First Book of Moses, Commonly Called Genesis',
+  abbreviation: 'Gen',
+  canon: 'old_testament',
+  ...overrides,
+});
+
+/**
+ * Creates a mock Bible chapter for testing
+ * @param overrides Optional properties to override defaults
+ */
+export const createMockChapter = (overrides?: Partial<BibleChapter>): BibleChapter => ({
+  id: '1',
+  passage_id: 'GEN.1',
+  title: '1',
+  ...overrides,
+});
+
+/**
+ * Creates a mock Bible verse for testing
+ * @param overrides Optional properties to override defaults
+ */
+export const createMockVerse = (overrides?: Partial<BibleVerse>): BibleVerse => ({
+  id: '1',
+  passage_id: 'GEN.1.1',
+  title: '1',
+  ...overrides,
+});

package/src/context/ReaderProvider.test.tsx

@@ -0,0 +1,264 @@
+import { describe, it, expect, vi } from 'vitest';
+import { renderHook, act } from '@testing-library/react';
+import React from 'react';
+import { useReaderContext } from './ReaderContext';
+import { ReaderProvider } from './ReaderProvider';
+import {
+  createMockBook,
+  createMockChapter,
+  createMockVerse,
+  createMockVersion,
+} from '../__tests__/mocks/bibles';
+
+// Mock Bible data
+const mockVersion = createMockVersion();
+const mockBook = createMockBook();
+const mockChapter = createMockChapter();
+const mockVerse = createMockVerse();
+
+// Alternative mock data for update tests
+const mockVersion2 = createMockVersion({
+  id: 2,
+  title: 'New International Version',
+  abbreviation: 'NIV',
+  localized_abbreviation: 'NIV',
+  localized_title: 'New International Version',
+  youversion_deep_link: 'https://www.bible.com/versions/2',
+});
+
+const mockBook2 = createMockBook({
+  id: 'JHN',
+  title: 'John',
+  full_title: 'The Gospel According to John',
+  abbreviation: 'Jn',
+  canon: 'new_testament',
+});
+
+const mockChapter2 = createMockChapter({
+  id: '3',
+  passage_id: 'JHN.3',
+  title: '3',
+});
+
+const mockVerse2 = createMockVerse({
+  id: '16',
+  passage_id: 'JHN.3.16',
+  title: '16',
+});
+
+// Test wrappers
+const wrapper = ({ children }: { children: React.ReactNode }) => (
+  <ReaderProvider
+    currentVersion={mockVersion}
+    currentBook={mockBook}
+    currentChapter={mockChapter}
+    currentVerse={mockVerse}
+  >
+    {children}
+  </ReaderProvider>
+);
+
+const wrapperWithNullVerse = ({ children }: { children: React.ReactNode }) => (
+  <ReaderProvider
+    currentVersion={mockVersion}
+    currentBook={mockBook}
+    currentChapter={mockChapter}
+    currentVerse={null}
+  >
+    {children}
+  </ReaderProvider>
+);
+
+describe('ReaderProvider', () => {
+  describe('initialization', () => {
+    it('should initialize with provided version', () => {
+      const { result } = renderHook(() => useReaderContext(), { wrapper });
+
+      expect(result.current.currentVersion).toEqual(mockVersion);
+    });
+
+    it('should initialize with provided book', () => {
+      const { result } = renderHook(() => useReaderContext(), { wrapper });
+
+      expect(result.current.currentBook).toEqual(mockBook);
+    });
+
+    it('should initialize with provided chapter', () => {
+      const { result } = renderHook(() => useReaderContext(), { wrapper });
+
+      expect(result.current.currentChapter).toEqual(mockChapter);
+    });
+
+    it('should initialize with provided verse', () => {
+      const { result } = renderHook(() => useReaderContext(), { wrapper });
+
+      expect(result.current.currentVerse).toEqual(mockVerse);
+    });
+
+    it('should initialize with null verse when provided', () => {
+      const { result } = renderHook(() => useReaderContext(), { wrapper: wrapperWithNullVerse });
+
+      expect(result.current.currentVerse).toBeNull();
+    });
+
+    it('should throw error when useReaderContext is used outside provider', () => {
+      const consoleError = vi.spyOn(console, 'error').mockImplementation(() => undefined);
+
+      expect(() => renderHook(() => useReaderContext())).toThrow(
+        'useReaderContext() must be used within a ReaderProvider',
+      );
+
+      consoleError.mockRestore();
+    });
+  });
+
+  describe('setVersion', () => {
+    it('should update version when setVersion is called', () => {
+      const { result } = renderHook(() => useReaderContext(), { wrapper });
+
+      act(() => {
+        result.current.setVersion(mockVersion2);
+      });
+
+      expect(result.current.currentVersion).toEqual(mockVersion2);
+    });
+
+    it('should preserve other state when version changes', () => {
+      const { result } = renderHook(() => useReaderContext(), { wrapper });
+
+      act(() => {
+        result.current.setVersion(mockVersion2);
+      });
+
+      expect(result.current.currentVersion).toMatchObject({ abbreviation: 'NIV' });
+      expect(result.current.currentBook).toEqual(mockBook);
+      expect(result.current.currentChapter).toEqual(mockChapter);
+      expect(result.current.currentVerse).toEqual(mockVerse);
+    });
+  });
+
+  describe('setBook', () => {
+    it('should update book when setBook is called', () => {
+      const { result } = renderHook(() => useReaderContext(), { wrapper });
+
+      act(() => {
+        result.current.setBook(mockBook2);
+      });
+
+      expect(result.current.currentBook).toEqual(mockBook2);
+    });
+
+    it('should preserve other state when book changes', () => {
+      const { result } = renderHook(() => useReaderContext(), { wrapper });
+
+      act(() => {
+        result.current.setBook(mockBook2);
+      });
+
+      expect(result.current.currentBook).toMatchObject({ id: 'JHN' });
+      expect(result.current.currentVersion).toEqual(mockVersion);
+      expect(result.current.currentChapter).toEqual(mockChapter);
+      expect(result.current.currentVerse).toEqual(mockVerse);
+    });
+  });
+
+  describe('setChapter', () => {
+    it('should update chapter when setChapter is called', () => {
+      const { result } = renderHook(() => useReaderContext(), { wrapper });
+
+      act(() => {
+        result.current.setChapter(mockChapter2);
+      });
+
+      expect(result.current.currentChapter).toEqual(mockChapter2);
+    });
+
+    it('should preserve other state when chapter changes', () => {
+      const { result } = renderHook(() => useReaderContext(), { wrapper });
+
+      act(() => {
+        result.current.setChapter(mockChapter2);
+      });
+
+      expect(result.current.currentChapter).toMatchObject({ id: '3' });
+      expect(result.current.currentVersion).toEqual(mockVersion);
+      expect(result.current.currentBook).toEqual(mockBook);
+      expect(result.current.currentVerse).toEqual(mockVerse);
+    });
+  });
+
+  describe('setVerse', () => {
+    it('should update verse when setVerse is called', () => {
+      const { result } = renderHook(() => useReaderContext(), { wrapper });
+
+      act(() => {
+        result.current.setVerse(mockVerse2);
+      });
+
+      expect(result.current.currentVerse).toEqual(mockVerse2);
+    });
+
+    it('should update verse to null when setVerse is called with null', () => {
+      const { result } = renderHook(() => useReaderContext(), { wrapper });
+
+      act(() => {
+        result.current.setVerse(null);
+      });
+
+      expect(result.current.currentVerse).toBeNull();
+    });
+
+    it('should preserve other state when verse changes', () => {
+      const { result } = renderHook(() => useReaderContext(), { wrapper });
+
+      act(() => {
+        result.current.setVerse(mockVerse2);
+      });
+
+      expect(result.current.currentVerse).toMatchObject({ id: '16' });
+      expect(result.current.currentVersion).toEqual(mockVersion);
+      expect(result.current.currentBook).toEqual(mockBook);
+      expect(result.current.currentChapter).toEqual(mockChapter);
+    });
+
+    it('should preserve other state when verse changes to null', () => {
+      const { result } = renderHook(() => useReaderContext(), { wrapper });
+
+      act(() => {
+        result.current.setVerse(null);
+      });
+
+      expect(result.current.currentVerse).toBeNull();
+      expect(result.current.currentVersion).toEqual(mockVersion);
+      expect(result.current.currentBook).toEqual(mockBook);
+      expect(result.current.currentChapter).toEqual(mockChapter);
+    });
+  });
+
+  describe('state persistence', () => {
+    it('should initialize with all provided props', () => {
+      const { result } = renderHook(() => useReaderContext(), { wrapper });
+
+      expect(result.current.currentVersion).toEqual(mockVersion);
+      expect(result.current.currentBook).toEqual(mockBook);
+      expect(result.current.currentChapter).toEqual(mockChapter);
+      expect(result.current.currentVerse).toEqual(mockVerse);
+    });
+
+    it('should handle rapid successive state updates without corruption', () => {
+      const { result } = renderHook(() => useReaderContext(), { wrapper });
+
+      act(() => {
+        result.current.setVersion(mockVersion2);
+        result.current.setBook(mockBook2);
+        result.current.setChapter(mockChapter2);
+        result.current.setVerse(mockVerse2);
+      });
+
+      expect(result.current.currentVersion).toEqual(mockVersion2);
+      expect(result.current.currentBook).toEqual(mockBook2);
+      expect(result.current.currentChapter).toEqual(mockChapter2);
+      expect(result.current.currentVerse).toEqual(mockVerse2);
+    });
+  });
+});