@youversion/platform-react-hooks 0.4.1

package/dist/useVersion.js

@@ -0,0 +1,11 @@
+'use client';
+import { useBibleClient } from './useBibleClient';
+import { useApiData } from './useApiData';
+export function useVersion(versionId, options) {
+    const bibleClient = useBibleClient();
+    const { data: version, loading, error, refetch, } = useApiData(() => bibleClient.getVersion(versionId), [bibleClient, versionId], {
+        enabled: options?.enabled !== false,
+    });
+    return { version, loading, error, refetch };
+}
+//# sourceMappingURL=useVersion.js.map

package/dist/useVersion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVersion.js","sourceRoot":"","sources":["../src/useVersion.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,UAAU,CACxB,SAAiB,EACjB,OAA2B;IAO3B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,MAAM,EACJ,IAAI,EAAE,OAAO,EACb,OAAO,EACP,KAAK,EACL,OAAO,GACR,GAAG,UAAU,CAAe,GAAG,EAAE,CAAC,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE;QAC9F,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,KAAK;KACpC,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC9C,CAAC"}

package/dist/useVersions.d.ts

@@ -0,0 +1,9 @@
+import { type UseApiDataOptions } from './useApiData';
+import type { Collection, BibleVersion } from '@youversion/platform-core';
+export declare function useVersions(languageRanges?: string, licenseId?: string | number, options?: UseApiDataOptions): {
+    versions: Collection<BibleVersion> | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => void;
+};
+//# sourceMappingURL=useVersions.d.ts.map

package/dist/useVersions.d.ts.map

@@ -0,0 +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"}

package/dist/useVersions.js

@@ -0,0 +1,11 @@
+'use client';
+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], {
+        enabled: options?.enabled !== false,
+    });
+    return { versions, loading, error, refetch };
+}
+//# sourceMappingURL=useVersions.js.map

package/dist/useVersions.js.map

@@ -0,0 +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"}

package/dist/utility/extractTextFromHTML.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Extracts readable text from an HTML string, focusing on content spans.
+ * This is needed because verses include markup for labels, footnotes, etc.
+ *
+ * @param html - The HTML content to extract text from
+ * @returns Plain text with normalized whitespace
+ */
+export declare function extractTextFromHtml(html: string): string;
+//# sourceMappingURL=extractTextFromHTML.d.ts.map

package/dist/utility/extractTextFromHTML.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractTextFromHTML.d.ts","sourceRoot":"","sources":["../../src/utility/extractTextFromHTML.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAcxD"}

package/dist/utility/extractTextFromHTML.js

@@ -0,0 +1,21 @@
+/**
+ * Extracts readable text from an HTML string, focusing on content spans.
+ * This is needed because verses include markup for labels, footnotes, etc.
+ *
+ * @param html - The HTML content to extract text from
+ * @returns Plain text with normalized whitespace
+ */
+export function extractTextFromHtml(html) {
+    if (!html)
+        return '';
+    const container = document.createElement('div');
+    container.innerHTML = html;
+    // Extract text from content spans and join with spaces
+    const contentText = Array.from(container.querySelectorAll('span.content'))
+        .map((el) => (el.textContent || '').trim())
+        .filter(Boolean)
+        .join(' ');
+    // Normalize whitespace
+    return contentText.replace(/\s+/g, ' ').trim();
+}
+//# sourceMappingURL=extractTextFromHTML.js.map

package/dist/utility/extractTextFromHTML.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractTextFromHTML.js","sourceRoot":"","sources":["../../src/utility/extractTextFromHTML.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,MAAM,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAChD,SAAS,CAAC,SAAS,GAAG,IAAI,CAAC;IAE3B,uDAAuD;IACvD,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAc,cAAc,CAAC,CAAC;SACpF,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;SAC1C,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,uBAAuB;IACvB,OAAO,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACjD,CAAC"}

package/dist/utility/extractVersesFromHTML.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Splits a passage HTML into an array of verse HTML strings.
+ * Expects markers like: <span class="yv-v" v="N"></span><span class="yv-vlbl">N</span>
+ */
+export declare function extractVersesFromHTML(html: string | null | undefined): {
+    verse: number;
+    html: string;
+}[];
+//# sourceMappingURL=extractVersesFromHTML.d.ts.map

package/dist/utility/extractVersesFromHTML.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractVersesFromHTML.d.ts","sourceRoot":"","sources":["../../src/utility/extractVersesFromHTML.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC9B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAwBnC"}

package/dist/utility/extractVersesFromHTML.js

@@ -0,0 +1,26 @@
+/**
+ * Splits a passage HTML into an array of verse HTML strings.
+ * Expects markers like: <span class="yv-v" v="N"></span><span class="yv-vlbl">N</span>
+ */
+export function extractVersesFromHTML(html) {
+    if (!html)
+        return [];
+    const results = [];
+    const pattern = /<span class="yv-v" v="(\d+)"><\/span><span class="yv-vlbl">\d+<\/span>/g;
+    let execResult;
+    const indices = [];
+    while ((execResult = pattern.exec(html)) !== null) {
+        const verseNumString = execResult[1];
+        indices.push({ verse: parseInt(verseNumString, 10), index: execResult.index });
+    }
+    for (let i = 0; i < indices.length; i++) {
+        const current = indices[i];
+        const next = indices[i + 1];
+        const start = current.index;
+        const end = next ? next.index : html.length;
+        const slice = html.slice(start, end).trim();
+        results.push({ verse: current.verse, html: slice });
+    }
+    return results;
+}
+//# sourceMappingURL=extractVersesFromHTML.js.map

package/dist/utility/extractVersesFromHTML.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractVersesFromHTML.js","sourceRoot":"","sources":["../../src/utility/extractVersesFromHTML.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAA+B;IAE/B,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,MAAM,OAAO,GAAsC,EAAE,CAAC;IACtD,MAAM,OAAO,GAAG,yEAAyE,CAAC;IAE1F,IAAI,UAAkC,CAAC;IACvC,MAAM,OAAO,GAAuC,EAAE,CAAC;IAEvD,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,cAAc,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5C,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/utility/getDayOfYear.d.ts

@@ -0,0 +1,2 @@
+export declare function getDayOfYear(date: Date): number;
+//# sourceMappingURL=getDayOfYear.d.ts.map

package/dist/utility/getDayOfYear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDayOfYear.d.ts","sourceRoot":"","sources":["../../src/utility/getDayOfYear.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAK/C"}

package/dist/utility/getDayOfYear.js

@@ -0,0 +1,5 @@
+export function getDayOfYear(date) {
+    const dayOfYear = Math.floor((date.getTime() - new Date(date.getFullYear(), 0, 0).getTime()) / 86400000);
+    return dayOfYear;
+}
+//# sourceMappingURL=getDayOfYear.js.map

package/dist/utility/getDayOfYear.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDayOfYear.js","sourceRoot":"","sources":["../../src/utility/getDayOfYear.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAC,IAAU;IACrC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAC1B,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,QAAQ,CAC3E,CAAC;IACF,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/utility/index.d.ts

@@ -0,0 +1,6 @@
+export * from './extractTextFromHTML';
+export * from './useDebounce';
+export * from './version';
+export * from './extractVersesFromHTML';
+export * from './getDayOfYear';
+//# sourceMappingURL=index.d.ts.map

package/dist/utility/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utility/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC"}

package/dist/utility/index.js

@@ -0,0 +1,6 @@
+export * from './extractTextFromHTML';
+export * from './useDebounce';
+export * from './version';
+export * from './extractVersesFromHTML';
+export * from './getDayOfYear';
+//# sourceMappingURL=index.js.map

package/dist/utility/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utility/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC"}

package/dist/utility/useDebounce.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Custom hook for debouncing a value.
+ *
+ * The hook delays the update of the given value until a specified delay has passed
+ * after the last change. It is commonly used to optimize the performance of
+ * functions that depend on user input or rapidly updating values.
+ *
+ * @param value - The input value to be debounced.
+ * @param delay - The duration in milliseconds to delay the update of the value.
+ *
+ * @returns The debounced value, updated after the specified delay.
+ */
+export declare function useDebounce<T>(value: T, delay: number): T;
+//# sourceMappingURL=useDebounce.d.ts.map

package/dist/utility/useDebounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebounce.d.ts","sourceRoot":"","sources":["../../src/utility/useDebounce.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAYzD"}

package/dist/utility/useDebounce.js

@@ -0,0 +1,24 @@
+import { useEffect, useState } from 'react';
+/**
+ * Custom hook for debouncing a value.
+ *
+ * The hook delays the update of the given value until a specified delay has passed
+ * after the last change. It is commonly used to optimize the performance of
+ * functions that depend on user input or rapidly updating values.
+ *
+ * @param value - The input value to be debounced.
+ * @param delay - The duration in milliseconds to delay the update of the value.
+ *
+ * @returns The debounced value, updated after the specified delay.
+ */
+export function useDebounce(value, delay) {
+    const [debouncedValue, setDebouncedValue] = useState(value);
+    useEffect(() => {
+        const handler = setTimeout(() => {
+            setDebouncedValue(value);
+        }, delay);
+        return () => clearTimeout(handler);
+    }, [value, delay]);
+    return debouncedValue;
+}
+//# sourceMappingURL=useDebounce.js.map

package/dist/utility/useDebounce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebounce.js","sourceRoot":"","sources":["../../src/utility/useDebounce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAI,KAAQ,EAAE,KAAa;IACpD,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE5D,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC,EAAE,KAAK,CAAC,CAAC;QAEV,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAEnB,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/utility/version.d.ts

@@ -0,0 +1,3 @@
+import type { BibleVersion } from '@youversion/platform-core';
+export declare function getISOFromVersion(version: BibleVersion): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/utility/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/utility/version.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAE/D"}

package/dist/utility/version.js

@@ -0,0 +1,4 @@
+export function getISOFromVersion(version) {
+    return version?.language_tag || 'unknown';
+}
+//# sourceMappingURL=version.js.map

package/dist/utility/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/utility/version.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iBAAiB,CAAC,OAAqB;IACrD,OAAO,OAAO,EAAE,YAAY,IAAI,SAAS,CAAC;AAC5C,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@youversion/platform-react-hooks",
+  "version": "0.4.1",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/youversion/platform-sdk-react",
+    "directory": "packages/hooks"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@youversion/platform-core": "0.4.1"
+  },
+  "peerDependencies": {
+    "react": "19.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.4.0",
+    "@testing-library/react": "^16.0.0",
+    "@types/react": "19.2.2",
+    "jsdom": "27.0.1",
+    "@vitejs/plugin-react": "^4.2.1",
+    "eslint": "9.38.0",
+    "typescript": "5.9.3",
+    "vitest": "4.0.4",
+    "@internal/eslint-config": "0.0.0",
+    "@internal/tsconfig": "0.0.0"
+  },
+  "scripts": {
+    "dev": "tsc --watch",
+    "build": "tsc -p tsconfig.build.json",
+    "lint": "eslint . --max-warnings 0",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  }
+}

package/src/context/BibleSDKContext.tsx

@@ -0,0 +1,9 @@
+'use client';
+
+import { createContext } from 'react';
+
+type BibleSDKContextData = {
+  appId: string;
+};
+
+export const BibleSDKContext = createContext<BibleSDKContextData | null>(null);

package/src/context/BibleSDKProvider.tsx

@@ -0,0 +1,16 @@
+'use client';
+
+import type { PropsWithChildren, ReactNode } from 'react';
+import { BibleSDKContext } from './BibleSDKContext';
+
+type BibleSDKProviderProps = {
+  children: ReactNode;
+  appId: string;
+};
+
+export function BibleSDKProvider({
+  appId,
+  children,
+}: PropsWithChildren<BibleSDKProviderProps>): React.ReactElement {
+  return <BibleSDKContext.Provider value={{ appId }}>{children}</BibleSDKContext.Provider>;
+}

package/src/context/ReaderContext.tsx

@@ -0,0 +1,27 @@
+'use client';
+
+import { createContext, useContext } from 'react';
+import type { BibleBook, BibleChapter, BibleVerse, BibleVersion } from '@youversion/platform-core';
+
+type ReaderContextData = {
+  currentVersion: BibleVersion;
+  currentChapter: BibleChapter;
+  currentBook: BibleBook;
+  currentVerse: BibleVerse | null;
+  setVersion: (version: BibleVersion) => void;
+  setChapter: (chapter: BibleChapter) => void;
+  setBook: (book: BibleBook) => void;
+  setVerse: (verse: BibleVerse | null) => void;
+};
+
+export const ReaderContext = createContext<ReaderContextData | null>(null);
+
+export function useReaderContext(): ReaderContextData {
+  const context = useContext(ReaderContext);
+
+  if (!context) {
+    throw new Error('useReaderContext() must be used within a ReaderProvider');
+  }
+
+  return context;
+}

package/src/context/ReaderProvider.tsx

@@ -0,0 +1,36 @@
+'use client';
+
+import { type PropsWithChildren, useState } from 'react';
+import { ReaderContext } from './ReaderContext';
+import type { BibleBook, BibleChapter, BibleVerse, BibleVersion } from '@youversion/platform-core';
+
+type ReaderProviderProps = {
+  currentVersion: BibleVersion;
+  currentChapter: BibleChapter;
+  currentBook: BibleBook;
+  currentVerse: BibleVerse | null;
+};
+
+export function ReaderProvider(props: PropsWithChildren<ReaderProviderProps>): React.ReactElement {
+  const [currentVersion, setCurrentVersion] = useState<BibleVersion>(props.currentVersion);
+  const [currentBook, setCurrentBook] = useState<BibleBook>(props.currentBook);
+  const [currentChapter, setCurrentChapter] = useState<BibleChapter>(props.currentChapter);
+  const [currentVerse, setCurrentVerse] = useState<BibleVerse | null>(props.currentVerse);
+
+  return (
+    <ReaderContext.Provider
+      value={{
+        currentVersion,
+        currentBook,
+        currentChapter,
+        currentVerse,
+        setVersion: setCurrentVersion,
+        setChapter: setCurrentChapter,
+        setBook: setCurrentBook,
+        setVerse: setCurrentVerse,
+      }}
+    >
+      {props.children}
+    </ReaderContext.Provider>
+  );
+}

package/src/context/VerseSelectionContext.tsx

@@ -0,0 +1,11 @@
+import { createContext } from 'react';
+
+export type VerseSelectionContextData = {
+  selectedVerseUsfms: Set<string>;
+  toggleVerse: (usfm: string) => void;
+  isSelected: (usfm: string) => boolean;
+  clearSelection: () => void;
+  selectedCount: number;
+};
+
+export const VerseSelectionContext = createContext<VerseSelectionContextData | null>(null);

package/src/context/VerseSelectionProvider.tsx

@@ -0,0 +1,39 @@
+import { type PropsWithChildren, useCallback, useState } from 'react';
+import { VerseSelectionContext } from './VerseSelectionContext';
+
+export function VerseSelectionProvider({ children }: PropsWithChildren): React.ReactElement {
+  const [selectedVerseUsfms, setSelectedVerseUsfms] = useState<Set<string>>(new Set());
+
+  const toggleVerse = useCallback((usfm: string) => {
+    setSelectedVerseUsfms((prev) => {
+      const newSet = new Set(prev); // Make a new set to trigger rerender
+      if (newSet.has(usfm)) {
+        newSet.delete(usfm);
+      } else {
+        newSet.add(usfm);
+      }
+      return newSet;
+    });
+  }, []);
+
+  const isSelected = useCallback(
+    (usfm: string) => {
+      return selectedVerseUsfms.has(usfm);
+    },
+    [selectedVerseUsfms],
+  );
+
+  const clearSelection = useCallback(() => {
+    setSelectedVerseUsfms(new Set());
+  }, []);
+
+  const value = {
+    selectedVerseUsfms,
+    toggleVerse,
+    isSelected,
+    clearSelection,
+    selectedCount: selectedVerseUsfms.size,
+  };
+
+  return <VerseSelectionContext.Provider value={value}>{children}</VerseSelectionContext.Provider>;
+}

package/src/context/index.ts

@@ -0,0 +1,6 @@
+export * from './BibleSDKContext';
+export * from './BibleSDKProvider';
+export * from './ReaderContext';
+export * from './ReaderProvider';
+export * from './VerseSelectionProvider';
+export * from './VerseSelectionContext';

package/src/index.ts

@@ -0,0 +1,20 @@
+export * from './useBook';
+export * from './useBooks';
+export * from './useChapter';
+export * from './useChapters';
+export * from './useVerse';
+export * from './useVerses';
+export * from './useVersion';
+export * from './utility/useDebounce';
+export * from './useVersions';
+export * from './useFilteredVersions';
+export * from './context';
+export * from './utility';
+export * from './useBibleClient';
+export * from './useVerseSelection';
+export * from './useChapterNavigation';
+export * from './useInitData';
+export * from './usePassage';
+export * from './useVOTD';
+export * from './useHighlights';
+export * from './useLanguages';

package/src/test/setup.ts

@@ -0,0 +1,9 @@
+// Vitest setup file
+import { afterEach } from 'vitest';
+import { cleanup } from '@testing-library/react';
+import '@testing-library/jest-dom/vitest';
+
+// Clean up after each test
+afterEach(() => {
+  cleanup();
+});

package/src/useApiData.ts

@@ -0,0 +1,71 @@
+'use client';
+
+import { useState, useEffect, useCallback } from 'react';
+
+export type UseApiDataOptions = {
+  enabled?: boolean;
+};
+
+type UseApiDataResult<T> = {
+  data: T | null;
+  loading: boolean;
+  error: Error | null;
+  refetch: () => void;
+};
+
+export function useApiData<T>(
+  fetchFn: () => Promise<T>,
+  deps: React.DependencyList,
+  options: UseApiDataOptions = {},
+): UseApiDataResult<T> {
+  const { enabled = true } = options;
+
+  const [data, setData] = useState<T | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<Error | null>(null);
+
+  const fetchData = useCallback(() => {
+    if (!enabled) {
+      setLoading(false);
+      return;
+    }
+
+    let canceled = false;
+
+    setLoading(true);
+    setError(null);
+
+    fetchFn()
+      .then((result) => {
+        if (!canceled) {
+          setData(result);
+        }
+      })
+      .catch((err) => {
+        if (!canceled) {
+          setError(err as Error);
+        }
+      })
+      .finally(() => {
+        if (!canceled) {
+          setLoading(false);
+        }
+      });
+
+    return () => {
+      canceled = true;
+    };
+  }, [fetchFn, enabled]);
+
+  const refetch = useCallback(() => {
+    fetchData();
+  }, [fetchData]);
+
+  useEffect(() => {
+    const cleanup = fetchData();
+    return cleanup;
+    // @eslint-disable-next-line react-hooks/exhaustive-deps
+  }, deps);
+
+  return { data, loading, error, refetch };
+}