@youversion/platform-core 1.21.0 → 1.22.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @youversion/platform-core@1.21.0 build /home/runner/work/platform-sdk-react/platform-sdk-react/packages/core
+> @youversion/platform-core@1.22.0 build /home/runner/work/platform-sdk-react/platform-sdk-react/packages/core
 > tsup src/index.ts src/browser.ts src/server.ts --format cjs,esm --dts
 
 CLI Building entry: src/browser.ts, src/index.ts, src/server.ts
@@ -8,17 +8,17 @@
 CLI Target: es2022
 CJS Build start
 ESM Build start
-ESM dist/browser.js        135.00 B
-ESM dist/server.js         443.00 B
 ESM dist/index.js          53.56 KB
 ESM dist/chunk-2Z2S2WY3.js 7.74 KB
-ESM ⚡️ Build success in 65ms
+ESM dist/server.js         443.00 B
+ESM dist/browser.js        135.00 B
+ESM ⚡️ Build success in 58ms
 CJS dist/browser.cjs 8.75 KB
 CJS dist/index.cjs   64.03 KB
 CJS dist/server.cjs  8.76 KB
-CJS ⚡️ Build success in 66ms
+CJS ⚡️ Build success in 58ms
 DTS Build start
-DTS ⚡️ Build success in 3000ms
+DTS ⚡️ Build success in 2493ms
 DTS dist/server.d.cts           863.00 B
 DTS dist/index.d.cts            33.68 KB
 DTS dist/browser.d.cts          93.00 B

package/AGENTS.md

@@ -1,7 +1,7 @@
 # @youversion/platform-core
 
 ## OVERVIEW
-Foundation package providing pure TypeScript API clients for YouVersion services with zero React dependencies.
+Foundation package providing pure TypeScript API clients for YouVersion services with zero React dependencies. Also provides framework-agnostic browser CSS (design tokens, preflight reset, Bible reader typography) so any web platform can render Bible content with proper styling.
 
 **Related packages:**
 - For React hooks wrapping these clients → see `packages/hooks/AGENTS.md`
@@ -10,6 +10,11 @@ Foundation package providing pure TypeScript API clients for YouVersion services
 ## STRUCTURE
 ```
 schemas/                     # Zod schemas for all data types (schema-first design)
+styles/                      # Browser CSS (exported via ./browser/styles/*)
+  fonts.css                  # Google Fonts import (Inter, Source Serif 4)
+  theme.css                  # --yv-* design tokens on :root, dark mode, scoped preflight
+  bible-reader.css           # USFM/Bible typography for [data-slot='yv-bible-renderer']
+  index.css                  # Barrel: imports fonts + theme + bible-reader
 client.ts                    # ApiClient - main HTTP client
 bible.ts                     # BibleClient - Bible data operations
 languages.ts                 # LanguagesClient - language data
@@ -25,6 +30,8 @@ index.ts                     # Main entry point (runtime-agnostic)
 ```
 
 ## PUBLIC API
+
+### TypeScript (`@youversion/platform-core`)
 - `ApiClient`: Main HTTP client with auth handling
 - `BibleClient`: Fetch Bibles, chapters, verses, versions
 - `LanguagesClient`: Get available languages
@@ -34,18 +41,20 @@ index.ts                     # Main entry point (runtime-agnostic)
 - `transformBibleHtml`: Runtime-agnostic Bible HTML transformer (requires DOM adapters)
 - `TransformBibleHtmlOptions`: Options for DOM parsing and serialization
 
+### Browser CSS (`@youversion/platform-core/browser/styles/*`)
+- `index.css`: All-in-one import (fonts + theme + bible-reader)
+- `theme.css`: `--yv-*` design tokens on `:root` + dark mode (`[data-yv-theme='dark']`) + scoped preflight
+- `bible-reader.css`: USFM typography for `[data-slot='yv-bible-renderer']` or `[data-yv-sdk-bible-reader]`
+- `fonts.css`: Google Fonts import (Inter, Source Serif 4)
+
 ## DOs / DON'Ts
 
-✅ Do: Keep this package **framework-agnostic** (no React, no environment-specific dependencies in main export)
-✅ Do: Provide pure, runtime-agnostic functions as the main export
-✅ Do: Use environment-specific entry points (`/browser`, `/server`) for convenience wrappers
+✅ Do: Keep this package **framework-agnostic**, but if you must target server or browser, those files must export from `/server` or `/browser`
 ✅ Do: Define all input/output types in `schemas/` using Zod; schemas are the single source of truth
 ✅ Do: Reuse `YouVersionAPI` base client for new service clients
 ✅ Do: Parse API responses with Zod schemas for validation
 
-❌ Don't: Import React or React-specific APIs
-❌ Don't: Bundle linkedom in browser builds (use `/server` entry point for server-side code)
-❌ Don't: Include environment-specific code in the default entry point
+❌ Don't: Import React, `window`, `document`, or browser storage APIs, but if you must target the browser, those files must export from `/browser`
 ❌ Don't: Bypass Zod validation for API responses
 ❌ Don't: Implement UI, hooks, or React state here
 
@@ -112,6 +121,8 @@ This architecture keeps the main export truly runtime-agnostic while providing e
 - Storage: Abstract via StorageStrategy interface
 - Auth: PKCE flow with pluggable storage backends
 - Error handling: Zod validation for all API responses
+- Browser CSS: Plain CSS only (no Tailwind, no preprocessors), served from `src/styles/` without a build step
+- Two export namespaces: `"."` for TS (framework-agnostic), `"./browser"` for browser environments, and `"./server` for server environments
 
 ## TESTING
 

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @youversion/platform-core
 
+## 1.22.0
+
+### Minor Changes
+
+- ff14f28: We've moved our theme, fonts, and Bible CSS from the React package into our core JS package to make it more framework agnostic so that consumers using any web framework can include our CSS without the React peer dependency.
+
 ## 1.21.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youversion/platform-core",
-  "version": "1.21.0",
+  "version": "1.22.0",
   "type": "module",
   "publishConfig": {
     "access": "public",
@@ -25,6 +25,7 @@
       "import": "./dist/browser.js",
       "require": "./dist/browser.cjs"
     },
+    "./browser/styles/*": "./src/styles/*",
     "./server": {
       "types": "./dist/server.d.ts",
       "import": "./dist/server.js",