@dr33m/react-native-readium 5.0.0-rc.18 → 5.0.0-rc.20

package/CHANGELOG.md

@@ -0,0 +1,497 @@
+# [5.0.0-rc.17](https://github.com/5-stones/react-native-readium/compare/v5.0.0-rc.16...v5.0.0-rc.17) (2026-03-05)
+
+
+### Features
+
+* **android:** upgrade nitrogen to fix android issues ([3354e7e](https://github.com/5-stones/react-native-readium/commit/3354e7eb49b0594113a62c914719b2fd14e393a6))
+
+
+
+# [5.0.0-rc.16](https://github.com/5-stones/react-native-readium/compare/v5.0.0-rc.15...v5.0.0-rc.16) (2026-02-26)
+
+
+### Bug Fixes
+
+* **web:** sanitize initialLocation for back compat with old locators lacking position ([cbcf45f](https://github.com/5-stones/react-native-readium/commit/cbcf45f7a448540d80830cbc458652d8b02c7cbb))
+
+
+
+# [5.0.0-rc.15](https://github.com/5-stones/react-native-readium/compare/v5.0.0-rc.14...v5.0.0-rc.15) (2026-02-25)
+
+
+### Bug Fixes
+
+* **web:** fix an issue with the web build due to newer [@readium](https://github.com/readium) versions ([c1e9026](https://github.com/5-stones/react-native-readium/commit/c1e90269f2e9762aa30275e3b6569db508b5fea9))
+* **web:** fix various issues with readium web by upgrading the readium packages ([52dc0c4](https://github.com/5-stones/react-native-readium/commit/52dc0c443db251819f18675b8e982dad45c29396))
+
+
+
+# [5.0.0-rc.14](https://github.com/5-stones/react-native-readium/compare/v5.0.0-rc.13...v5.0.0-rc.14) (2026-02-25)
+
+
+### Bug Fixes
+
+* **android, ios:** unify sepia theme colors across platforms ([1e92b3a](https://github.com/5-stones/react-native-readium/commit/1e92b3a1a957f558da55ded6839efc62ff6ca076))
+
+
+
+# [5.0.0-rc.13](https://github.com/5-stones/react-native-readium/compare/v5.0.0-rc.12...v5.0.0-rc.13) (2026-02-25)
+
+
+### Bug Fixes
+
+* **web:** fix an issue with improper navigator teardown on web ([76fe730](https://github.com/5-stones/react-native-readium/commit/76fe7308b563f9b3ecc93615613015261f3eabcd))
+
+
+
+# [5.0.0-rc.12](https://github.com/5-stones/react-native-readium/compare/v5.0.0-rc.11...v5.0.0-rc.12) (2026-02-25)
+
+
+### Features
+
+* **android, ios, web:** replace location prop with imperative goTo() ref method ([0ce0635](https://github.com/5-stones/react-native-readium/commit/0ce06355060c69736afb8d81cfb7dfe2a18be9b5))
+
+
+### BREAKING CHANGES
+
+* **android, ios, web:** Navigation is now imperative only via ref.current.goTo(locator), matching the
+existing goForward()/goBackward() pattern. The useLocationObserver hook (web) is removed. Initial
+position on mount is still handled via File.initialLocation.
+
+
+
+# [5.0.0-rc.11](https://github.com/5-stones/react-native-readium/compare/v5.0.0-rc.10...v5.0.0-rc.11) (2026-02-25)
+
+
+### Bug Fixes
+
+* **web:** do not ignore location changes within hrefs and containing totalProgression (as bookmarks might) ([c5272f7](https://github.com/5-stones/react-native-readium/commit/c5272f7f87182a6900ee95e1ad967d5bf12c91bb))
+* **web:** if the manifests links to positions, use those for the positionArray ([48b9503](https://github.com/5-stones/react-native-readium/commit/48b9503251c68ad47246a43796e0dbd1183e8a41))
+
+
+
+# [5.0.0-rc.10](https://github.com/5-stones/react-native-readium/compare/v5.0.0-rc.9...v5.0.0-rc.10) (2026-02-24)
+
+
+### Features
+
+* **android, ios, web:** reimplement nested sub-navigation for ToC in nitro ([79c3329](https://github.com/5-stones/react-native-readium/commit/79c33297e28c47a024c3f2d07d2ba961781bff2d))
+
+
+### BREAKING CHANGES
+
+* **android, ios, web:** Several fields dropped from Link (templated, type, height, width, bitrate,
+duration, alternates). `rel`s changed from `Set<string>` to `string[]`
+
+
+
+# [5.0.0-rc.9](https://github.com/5-stones/react-native-readium/compare/v5.0.0-rc.8...v5.0.0-rc.9) (2026-02-19)
+
+
+### Bug Fixes
+
+* **android:** fix an issue with 16kb page sizes on android ([630e3b7](https://github.com/5-stones/react-native-readium/commit/630e3b73441ac4fcb6226303672fd7a97acd2d17))
+
+
+
+# [5.0.0-rc.8](https://github.com/5-stones/react-native-readium/compare/v5.0.0-rc.7...v5.0.0-rc.8) (2026-02-17)
+
+
+### Bug Fixes
+
+* **android:** fix runtime exception due to incorrect thread access ([f82c3f7](https://github.com/5-stones/react-native-readium/commit/f82c3f7afc3e6dbe52136e7a0a07b7730817d29b))
+
+
+
+# [5.0.0-rc.7](https://github.com/5-stones/react-native-readium/compare/v5.0.0-rc.6...v5.0.0-rc.7) (2026-02-17)
+
+
+### Bug Fixes
+
+* **android, ios:** cleanup reader views when unmounted ([e5e72a6](https://github.com/5-stones/react-native-readium/commit/e5e72a65d9b4a84dc6b87cd9d7d2bedeb55e3736))
+
+
+
+# [5.0.0-rc.6](https://github.com/5-stones/react-native-readium/compare/v5.0.0-rc.5...v5.0.0-rc.6) (2026-02-12)
+
+
+### Bug Fixes
+
+* **android:** fix an issue with android where switching between epubs wasn't working ([f3062a5](https://github.com/5-stones/react-native-readium/commit/f3062a5c3390c878772f460571e980fa4d8bb292))
+
+
+
+# [5.0.0-rc.5](https://github.com/5-stones/react-native-readium/compare/v5.0.0-rc.4...v5.0.0-rc.5) (2026-02-12)
+
+
+### Bug Fixes
+
+* **android, ios:** fix an issue with fragment parsing and remove dead code ([5fe514d](https://github.com/5-stones/react-native-readium/commit/5fe514d6856f945781c06e6f65ffe33399be461e))
+
+
+
+# [5.0.0-rc.4](https://github.com/5-stones/react-native-readium/compare/v5.0.0-rc.3...v5.0.0-rc.4) (2026-02-12)
+
+
+### Bug Fixes
+
+* **android, ios:** fix an selectionAction props causing rendering issues ([1d1ff03](https://github.com/5-stones/react-native-readium/commit/1d1ff039fe06150e14806244c4193a77c8df4acf))
+
+
+
+# [5.0.0-rc.3](https://github.com/5-stones/react-native-readium/compare/v5.0.0-rc.2...v5.0.0-rc.3) (2026-02-12)
+
+
+### Bug Fixes
+
+* **ios:** fix an install issue due to missing scripts in the npm distribution ([04388a3](https://github.com/5-stones/react-native-readium/commit/04388a33352a6fe3fe8f8933644f89b04f98807b))
+
+
+
+# [5.0.0-rc.2](https://github.com/5-stones/react-native-readium/compare/v5.0.0-rc.1...v5.0.0-rc.2) (2026-02-12)
+
+
+### Features
+
+* **ios, android:** fix some runtime errors, add install helper scripts, update docs ([7e8bbad](https://github.com/5-stones/react-native-readium/commit/7e8bbad39c20c3f46ffb419140df81dbfe18254a))
+
+
+### BREAKING CHANGES
+
+* **ios, android:** update your Podfile and use the `readium_pods` and `readium_post_install` helpers
+
+
+
+# [5.0.0-rc.1](https://github.com/5-stones/react-native-readium/compare/v5.0.0-rc.0...v5.0.0-rc.1) (2026-02-11)
+
+
+### Features
+
+* **android, ios:** add the ability to manage decorators ([8cdfa74](https://github.com/5-stones/react-native-readium/commit/8cdfa745a685937ebc256439ac2e9f13e1480ee6))
+* **android, ios:** update implementation to use nitro ([53c5e4c](https://github.com/5-stones/react-native-readium/commit/53c5e4cb2d3ecc42ea41b936d04aa846d86cb68e))
+
+
+### BREAKING CHANGES
+
+* **android, ios:** you'll need to add `react-native-nitro-modules` which is now a
+react-native-nitro-modules of this library
+
+
+
+# [5.0.0-rc.0](https://github.com/5-stones/react-native-readium/compare/v4.0.1...v5.0.0-rc.0) (2026-01-20)
+
+
+### Bug Fixes
+
+* **web:** fix typescript errors in web ([f8c1137](https://github.com/5-stones/react-native-readium/commit/f8c1137af8a0cc7a76e94aca21ca2b8adbce49e6))
+* **web:** update stylesheet urls to avoid redirect issue ([#98](https://github.com/5-stones/react-native-readium/issues/98)) ([005274d](https://github.com/5-stones/react-native-readium/commit/005274d59fd6260f4ac7579cfa1220cff72fb105))
+
+
+### Features
+
+* **android, example, src:** upgrade library to be compatible with react-native 0.83.x ([13df342](https://github.com/5-stones/react-native-readium/commit/13df342d29e6a461743d052c43286950790c8b3a))
+* **android, ios, web:** emit all book metadata via onPublicationReady callback ([d99a813](https://github.com/5-stones/react-native-readium/commit/d99a8134d03979c637e935be506ecb0e808589e8)), closes [#67](https://github.com/5-stones/react-native-readium/issues/67)
+* **android, web:** add page numbers on android and web for parity with ios ([3931e6e](https://github.com/5-stones/react-native-readium/commit/3931e6ebf36b087ce2738384fb99a2b06934ef57)), closes [#25](https://github.com/5-stones/react-native-readium/issues/25)
+* **android:** upgrade kotlin-toolkit to v3.1 ([#103](https://github.com/5-stones/react-native-readium/issues/103)) ([4dba322](https://github.com/5-stones/react-native-readium/commit/4dba32209bf23740242205baaf7f3f0841522cc1))
+* **apps:** split the web and native examples into separate apps for clarity ([cd80ec1](https://github.com/5-stones/react-native-readium/commit/cd80ec1cbfcc7f35c2fdfc865a4d1567c1a44b1f))
+* **ios:** upgrade ios implementation to use v3 of readiums swift-toolkit ([#96](https://github.com/5-stones/react-native-readium/issues/96)) ([db56fba](https://github.com/5-stones/react-native-readium/commit/db56fba6d801d42f288b69a5b4d3e507a08c463d))
+* **web:** migrate from @d-i-t-a/reader to readium's ts-toolkit ([cac915d](https://github.com/5-stones/react-native-readium/commit/cac915deb74d243d25f4f6298f4eb52d9029ca57))
+
+
+### BREAKING CHANGES
+
+* **android, ios, web:** onTableOfContents has been removed and replaced with onPublicationReady
+* **web:** while the migration from @d-i-t-a/reader to ts-toolkit should be mostly
+transparent, you should verify that everything in your app is working properly.
+* **ios:** Old v2.6 pods are not compatible anymore with this version. You should update Podfile and use v3.5 pods
+* **ios:** [Migration of HREFs and Locators (bookmarks, annotations, etc.)](https://github.com/readium/swift-toolkit/blob/develop/docs/Migration%20Guide.md#migration-of-hrefs-and-locators-bookmarks-annotations-etc)
+
+Co-authored-by: tyukesz <nagy.szabolcs@sonrisa.hu>
+
+
+
+## [4.0.1](https://github.com/5-stones/react-native-readium/compare/v4.0.0...v4.0.1) (2025-09-12)
+
+
+### Bug Fixes
+
+* **android:** ensure we don't reset preferences on updates ([#91](https://github.com/5-stones/react-native-readium/issues/91)) ([ce96f13](https://github.com/5-stones/react-native-readium/commit/ce96f1388987ceda90e7ef9251705d6787b51b3b))
+
+
+
+# [4.0.0](https://github.com/5-stones/react-native-readium/compare/v3.0.2...v4.0.0) (2025-09-08)
+
+
+### Bug Fixes
+
+* **android, ios:** Improve detection of Links when changing navigator location ([#82](https://github.com/5-stones/react-native-readium/issues/82)) ([9bc2e4a](https://github.com/5-stones/react-native-readium/commit/9bc2e4acc59af0c915fbddaad3375daa3f0b017d))
+* **ios:** add guards to superview and viewControllers to avoid crash ([#90](https://github.com/5-stones/react-native-readium/issues/90)) ([a85a065](https://github.com/5-stones/react-native-readium/commit/a85a065dc8956c5a03f59f2be379e6ee7f1e02ae))
+
+
+### Features
+
+* **ios, android, web:** Move from deprecated UserSettings API to the new Preferences API ([#80](https://github.com/5-stones/react-native-readium/issues/80)) ([784f7fe](https://github.com/5-stones/react-native-readium/commit/784f7fe072f12bfdc8ff8e8c2ea1109e007619a0)), closes [#79](https://github.com/5-stones/react-native-readium/issues/79)
+
+
+### BREAKING CHANGES
+
+* **ios, android, web:** This update moves the library to the newer Preferences API for managing the reader font size, theme, etc.
+
+
+
+## [3.0.2](https://github.com/5-stones/react-native-readium/compare/v3.0.1...v3.0.2) (2025-05-20)
+
+
+
+## [3.0.1](https://github.com/5-stones/react-native-readium/compare/v3.0.0...v3.0.1) (2025-03-05)
+
+
+### Bug Fixes
+
+* **android:** fix android build errors in newer versions of react-native ([487febb](https://github.com/5-stones/react-native-readium/commit/487febbb7ef7e16fc39db3594bbef10a61f28b07))
+
+
+
+# [3.0.0](https://github.com/5-stones/react-native-readium/compare/v2.0.2...v3.0.0) (2025-02-11)
+
+
+### Bug Fixes
+
+* **android:** remove tap toggles ui visibility ([81ca01a](https://github.com/5-stones/react-native-readium/commit/81ca01a4f38e2fb451023ce4aae31985f3613eb1))
+
+
+### BREAKING CHANGES
+
+* **android:** Tapping will no longer toggle the system ui visibility.
+
+
+
+## [2.0.2](https://github.com/5-stones/react-native-readium/compare/v2.0.1...v2.0.2) (2024-10-08)
+
+
+### Bug Fixes
+
+* **web:** Handle location not defined in reading order ([080b4a9](https://github.com/5-stones/react-native-readium/commit/080b4a911bea77ae174face2cf24b90ae0d58b32))
+
+
+
+## [2.0.1](https://github.com/5-stones/react-native-readium/compare/v2.0.0...v2.0.1) (2024-10-03)
+
+
+### Bug Fixes
+
+* **web:** estimate the totalProgression if it is not provided ([3d849dc](https://github.com/5-stones/react-native-readium/commit/3d849dc01cb23298acdfbfecead84c084bd4b1b2))
+
+
+
+# [2.0.0](https://github.com/5-stones/react-native-readium/compare/v2.0.0-rc.2...v2.0.0) (2024-09-10)
+
+
+### Bug Fixes
+
+* **web:** update reader when file url changes ([21eda29](https://github.com/5-stones/react-native-readium/commit/21eda2950ba01469220549387bbfc9f74b2e9047))
+
+
+
+# [2.0.0-rc.2](https://github.com/5-stones/react-native-readium/compare/v2.0.0-rc.1...v2.0.0-rc.2) (2024-07-29)
+
+
+### Bug Fixes
+
+* **android:** don't set the brightness of the activity. instead rely on device/app settings ([8af916b](https://github.com/5-stones/react-native-readium/commit/8af916b86a3c42a9abc02a63aa239fa6e8c4e8a5))
+* **readiumview:** fix an issue when no forwardRef is passed on Android ([bbc1967](https://github.com/5-stones/react-native-readium/commit/bbc1967d0278db6ba1af4948f5afd67d2a4d12b5))
+* **ReadiumView:** fix react warning regarding forwardRefs ([45792e6](https://github.com/5-stones/react-native-readium/commit/45792e6f92e9526282c1fc2e6d5f8f57e199ecd7))
+
+
+
+# [2.0.0-rc.0](https://github.com/5-stones/react-native-readium/compare/v1.2.1...v2.0.0-rc.0) (2024-07-26)
+
+
+### Features
+
+* **android, example:** upgrade react-native support to 0.74.3 and android to kotlin-toolkit@2.4.1 ([1479382](https://github.com/5-stones/react-native-readium/commit/1479382214d1acd59d7f76690d933459c745c5c7))
+
+
+
+## [1.2.1](https://github.com/5-stones/react-native-readium/compare/v1.2.0...v1.2.1) (2023-05-10)
+
+
+### Bug Fixes
+
+* **web:** restructure reader imports in order to fix SSR ([37a2e6a](https://github.com/5-stones/react-native-readium/commit/37a2e6ae8380b902f8e2b38b46e027b1965bfde6))
+
+
+
+# [1.2.0](https://github.com/5-stones/react-native-readium/compare/v1.1.0...v1.2.0) (2022-12-14)
+
+
+### Features
+
+* **web:** remove next and previous buttons in favor of a ref api ([0e03366](https://github.com/5-stones/react-native-readium/commit/0e033667eef2abf06dfb949ef831b68f9dc51d2c))
+
+
+
+# [1.1.0](https://github.com/5-stones/react-native-readium/compare/v1.0.4...v1.1.0) (2022-12-10)
+
+
+### Features
+
+* **web:** add basic web implementation and example ([d55a457](https://github.com/5-stones/react-native-readium/commit/d55a457b71213de4536294709788b50b74076622))
+
+
+
+## [1.0.4](https://github.com/5-stones/react-native-readium/compare/v1.0.3...v1.0.4) (2022-12-06)
+
+
+### Bug Fixes
+
+* **android:** fix an issue resulting in initial android settings not being applied correctly ([9f48874](https://github.com/5-stones/react-native-readium/commit/9f488746759f51effdbf62b3da1ffe036369bffd))
+
+
+
+## [1.0.3](https://github.com/5-stones/react-native-readium/compare/v1.0.2...v1.0.3) (2022-12-05)
+
+
+### Bug Fixes
+
+* **android, ios:** allow location and initialLocation to be either Link or Locator objects ([ebc1030](https://github.com/5-stones/react-native-readium/commit/ebc103075d305bcdf8db263d7455d5b07536288b))
+
+
+
+## [1.0.2](https://github.com/5-stones/react-native-readium/compare/v1.0.1...v1.0.2) (2022-12-01)
+
+
+### Bug Fixes
+
+* **android:** fix android release builds by adding networking security config ([f9b0ff8](https://github.com/5-stones/react-native-readium/commit/f9b0ff80676f9e673352546857faab2163e8a1bb))
+
+
+
+## [1.0.1](https://github.com/5-stones/react-native-readium/compare/v1.0.0...v1.0.1) (2022-12-01)
+
+
+### Bug Fixes
+
+* **android:** update readium dependencies to deal with removed nanohttpd dependency ([764f6eb](https://github.com/5-stones/react-native-readium/commit/764f6ebc1de0ddd509b7ca89dd736eace4348d3d))
+
+
+
+# [1.0.0](https://github.com/5-stones/react-native-readium/compare/v1.0.0-alpha.10...v1.0.0) (2022-08-22)
+
+
+
+# [1.0.0-alpha.10](https://github.com/5-stones/react-native-readium/compare/v1.0.0-alpha.9...v1.0.0-alpha.10) (2022-04-05)
+
+
+### Bug Fixes
+
+* **android, ios:** fix an issue with background color not staying in sync with appearance setting ([fca2f8e](https://github.com/5-stones/react-native-readium/commit/fca2f8e20e3ed0b5558caf1b3f2abd5f4f8bb3d5))
+
+
+
+# [1.0.0-alpha.9](https://github.com/5-stones/react-native-readium/compare/v1.0.0-alpha.8...v1.0.0-alpha.9) (2022-04-01)
+
+
+### Bug Fixes
+
+* **locator:** update the Locator interface to represent the minimum data required ([61c8be1](https://github.com/5-stones/react-native-readium/commit/61c8be1073e92a9c408ecde995e764502f2a5538))
+
+
+### Features
+
+* **android, ios, example:** add the ability to register to receive the table of contents ([94ef6ae](https://github.com/5-stones/react-native-readium/commit/94ef6ae790efe53cce8b3b945bfc4f0bd712e178))
+
+
+
+# [1.0.0-alpha.8](https://github.com/5-stones/react-native-readium/compare/v1.0.0-alpha.7...v1.0.0-alpha.8) (2022-03-31)
+
+
+### Bug Fixes
+
+* **android:** fix an issue with android crashing due to a "no view found for id" exception ([5440662](https://github.com/5-stones/react-native-readium/commit/54406625dfbca5c1dcfa23030df8325d53d2ddbb))
+
+
+
+# [1.0.0-alpha.7](https://github.com/5-stones/react-native-readium/compare/v1.0.0-alpha.6...v1.0.0-alpha.7) (2022-03-31)
+
+
+### Bug Fixes
+
+* **android:** fix a race-condition with the settings prop causing crashes ([11ebde3](https://github.com/5-stones/react-native-readium/commit/11ebde35184622ff045a41e8f971b46a389c0dc0))
+
+
+
+# [1.0.0-alpha.6](https://github.com/5-stones/react-native-readium/compare/v1.0.0-alpha.5...v1.0.0-alpha.6) (2022-03-29)
+
+
+### Features
+
+* **android:** strip the 'file://' prefix from the path if it's passed ([1171f1e](https://github.com/5-stones/react-native-readium/commit/1171f1e2ec553f51c7be1aa1b3973433f3bd6939))
+
+
+
+# [1.0.0-alpha.5](https://github.com/5-stones/react-native-readium/compare/v1.0.0-alpha.4...v1.0.0-alpha.5) (2022-03-28)
+
+
+### Bug Fixes
+
+* **android:** remove unused exoplayer deps to prevent conflicts with other projects ([96086b4](https://github.com/5-stones/react-native-readium/commit/96086b4cf0305b9799b6c632c4c6e57422375479))
+
+
+
+# [1.0.0-alpha.4](https://github.com/5-stones/react-native-readium/compare/v1.0.0-alpha.3...v1.0.0-alpha.4) (2022-03-24)
+
+
+### Bug Fixes
+
+* **ios:** fix an issue causing crash when used in conjunction with react-native-screens ([d250bf8](https://github.com/5-stones/react-native-readium/commit/d250bf8294e133a7fd29d3eb92e68f9682f46f63))
+
+
+
+# [1.0.0-alpha.3](https://github.com/5-stones/react-native-readium/compare/v1.0.0-alpha.2...v1.0.0-alpha.3) (2022-03-24)
+
+
+### Bug Fixes
+
+* **ios:** add ios.deployment_target of 13.0 ([ca1b199](https://github.com/5-stones/react-native-readium/commit/ca1b199bae3dea3347aed26135f1e1de61c61fff))
+
+
+
+# [1.0.0-alpha.2](https://github.com/5-stones/react-native-readium/compare/v1.0.0-alpha.1...v1.0.0-alpha.2) (2022-03-24)
+
+
+### Bug Fixes
+
+* **podspec:** specify swift version in podspec ([cc7d7cd](https://github.com/5-stones/react-native-readium/commit/cc7d7cd8ae7fc65623b06825f0431b7b79612ec1))
+
+
+### Features
+
+* **ios, android:** remove unused dependencies and code ([1d35cdd](https://github.com/5-stones/react-native-readium/commit/1d35cdd6ba9bfda33f72381bb880cb4a401e4154))
+
+
+
+# [1.0.0-alpha.1](https://github.com/5-stones/react-native-readium/compare/v1.0.0-alpha.0...v1.0.0-alpha.1) (2022-03-23)
+
+
+### Bug Fixes
+
+* **ios:** fix view sizing on iOS ([5e6e451](https://github.com/5-stones/react-native-readium/commit/5e6e451e6c4c75dcf35a11a1b348f8911660247f))
+
+
+### Features
+
+* **android:** implement a basic ebook reader view for android ([63e3d70](https://github.com/5-stones/react-native-readium/commit/63e3d70016675bbf3b2d2dea1acb47c32824dc7c))
+* **example:** react-native upgrade ([74997a2](https://github.com/5-stones/react-native-readium/commit/74997a20d0821dbd80493d5051a45e1ba9cec9b1))
+
+
+
+# [1.0.0-alpha.0](https://github.com/5-stones/react-native-readium/compare/47d18e28b8ee9a7e6cb83eb93837fbe6169d9180...v1.0.0-alpha.0) (2022-03-11)
+
+
+### Features
+
+* **src, ios:** Basic functional implementation of epub reader for iOS ([47d18e2](https://github.com/5-stones/react-native-readium/commit/47d18e28b8ee9a7e6cb83eb93837fbe6169d9180))
+
+
+

package/README.md

@@ -1,12 +1,46 @@
 # react-native-readium
 
-[![NPM version](https://img.shields.io/npm/v/react-native-readium.svg?color=success&label=npm%20package&logo=npm)](https://www.npmjs.com/package/react-native-readium)
+> **This is a fork of [5-stones/react-native-readium](https://github.com/5-stones/react-native-readium) maintained on the [`open-citadel-main`](https://github.com/dr-33-m/react-native-readium/tree/open-citadel-main) branch for the [Open Citadel](https://github.com/dr-33-m/open-citadel) project.**
+> Published to npm as [`@dr33m/react-native-readium`](https://www.npmjs.com/package/@dr33m/react-native-readium).
+>
+> See [What this fork adds](#what-this-fork-adds) for the full list of changes on top of upstream.
+
+[![NPM version](https://img.shields.io/npm/v/%40dr33m%2Freact-native-readium/next.svg?color=success&label=npm%20package&logo=npm)](https://www.npmjs.com/package/@dr33m/react-native-readium)
 [![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)
 ![PRs welcome!](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)
 ![This project is released under the MIT license](https://img.shields.io/badge/license-MIT-blue.svg)
 
 ---
 
+## What this fork adds
+
+This fork is built on top of `5.0.0-rc.17` of the upstream package and adds the following on the `open-citadel-main` branch:
+
+### Text-to-Speech (TTS)
+
+Full TTS support for EPUB books on Android and iOS:
+
+- **Android** — powered by the Readium `readium-navigator-media-tts` module, which uses the platform `TextToSpeech` engine (no ExoPlayer dependency).
+- **iOS** — powered by `AVSpeechSynthesizer` via the Readium Swift Toolkit's `PublicationSpeechSynthesizer`.
+- New prop **`tts`** — pass a `TTSConfig` object to start, stop, pause, resume, or seek TTS playback.
+- New callback **`onTTSStateChange`** — fires whenever TTS state changes (`playing`, `paused`, `stopped`).
+- New callback **`onTTSLocatorChange`** — fires with the current `Locator` as TTS advances through the book, allowing the UI to follow along.
+- New callback **`onTTSError`** — fires with an error message if TTS fails to initialise or encounters a read error.
+
+### Android Storage Access Framework (SAF) support
+
+`ReaderService.openPublication` now accepts `content://` URIs (Android SAF) in addition to raw file paths. The display name is resolved from the content resolver so bookId and file extension are always correctly extracted.
+
+### EPUB-only routing
+
+PDF support has been removed from this fork (it was experimental and caused crashes). Only EPUB publications are opened; any other format logs a warning and returns gracefully. `pdfFactory` is explicitly set to `null` in `DefaultPublicationParser`.
+
+### Readium Kotlin Toolkit bump
+
+Android native dependencies updated to `readium-kotlin-toolkit 3.1.2` (from `3.1.0` in upstream rc.17). The `readium-adapter-pdfium` dependency is removed entirely.
+
+---
+
 ## Have A Bug/Feature You Care About?
 
 We :heart: open source. We work on the things that are important to us when
@@ -60,13 +94,13 @@ This library uses [Nitro Modules](https://nitro.margelo.com/) and supports both
 **NPM**
 
 ```sh
-npm install react-native-readium react-native-nitro-modules
+npm install @dr33m/react-native-readium@next react-native-nitro-modules
 ```
 
 **Yarn**
 
 ```sh
-yarn add react-native-readium react-native-nitro-modules
+yarn add @dr33m/react-native-readium@next react-native-nitro-modules
 ```
 
 #### iOS

package/android/src/main/java/com/reactnativereadium/reader/BaseReaderFragment.kt

@@ -237,6 +237,7 @@ abstract class BaseReaderFragment : Fragment() {
           }
         },
         onUtterance = { locator, text ->
+          applyTTSDecoration(locator) // Apply decoration natively — no JS round-trip
           viewScope.launch {
             channel.send(ReaderViewModel.Event.TTSUtterance(locator, text, null, null))
           }
@@ -262,14 +263,47 @@ abstract class BaseReaderFragment : Fragment() {
     }
   }
 
-  fun ttsStop() { ttsManager?.stop() }
+  fun ttsStop() {
+    ttsManager?.stop()
+    clearTTSDecoration()
+  }
   fun ttsPause() { ttsManager?.pause() }
   fun ttsResume() { ttsManager?.resume() }
   fun ttsSetRate(rate: Float) { ttsManager?.setRate(rate) }
   fun ttsSkipNext() { ttsManager?.skipNext() }
   fun ttsSkipPrevious() { ttsManager?.skipPrevious() }
 
+  private fun applyTTSDecoration(locator: Locator) {
+    if (!isNavigatorReady) return
+    val decorableNavigator = navigator as? DecorableNavigator ?: return
+    val viewScope = viewLifecycleOwner.lifecycleScope
+    viewScope.launch {
+      decorableNavigator.applyDecorations(
+        listOf(
+          Decoration(
+            id = "tts-current",
+            locator = locator,
+            style = Decoration.Style.Highlight(
+              tint = android.graphics.Color.argb(89, 0xF2, 0xCA, 0x50) // #f2ca50 @ 35%
+            )
+          )
+        ),
+        "tts"
+      )
+    }
+  }
+
+  private fun clearTTSDecoration() {
+    if (!isNavigatorReady) return
+    val decorableNavigator = navigator as? DecorableNavigator ?: return
+    val viewScope = viewLifecycleOwner.lifecycleScope
+    viewScope.launch {
+      decorableNavigator.applyDecorations(emptyList(), "tts")
+    }
+  }
+
   override fun onDestroyView() {
+    clearTTSDecoration()
     ttsManager?.cleanup()
     ttsManager = null
     super.onDestroyView()

package/ios/HybridReadiumView.swift

@@ -318,6 +318,16 @@ class HybridReadiumView: HybridReadiumViewSpec {
         ))
       }
       manager.onUtterance = { [weak self] locator, text in
+        // Apply TTS decoration natively — bypass React prop round-trip
+        if let nav = self?.readerViewController?.navigator as? DecorableNavigator {
+          let tint = UIColor(red: 0.949, green: 0.792, blue: 0.314, alpha: 0.35) // #f2ca50 @ 35%
+          let decoration = RDecoration(
+            id: "tts-current",
+            locator: locator,
+            style: .highlight(tint: tint, isActive: false)
+          )
+          nav.apply(decorations: [decoration], in: "tts")
+        }
         self?.onTTSUtterance?(TTSUtteranceEvent(
           locator: readiumLocatorToNitro(locator),
           utterance: text,
@@ -343,7 +353,12 @@ class HybridReadiumView: HybridReadiumViewSpec {
     )
   }
 
-  func ttsStop() { readerViewController?.ttsManager?.stop() }
+  func ttsStop() {
+    if let nav = readerViewController?.navigator as? DecorableNavigator {
+      nav.apply(decorations: [], in: "tts")
+    }
+    readerViewController?.ttsManager?.stop()
+  }
   func ttsPause() { readerViewController?.ttsManager?.pause() }
   func ttsResume() { readerViewController?.ttsManager?.resume() }
   func ttsSetRate(rate: Double) { readerViewController?.ttsManager?.setRate(Float(rate)) }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dr33m/react-native-readium",
-  "version": "5.0.0-rc.18",
+  "version": "5.0.0-rc.20",
   "description": "A react-native wrapper for https://readium.org/",
   "main": "lib/src/index",
   "types": "lib/src/index.d.ts",
@@ -61,7 +61,12 @@
     "e-reader",
     "read"
   ],
-  "repository": "http://github.com/5-stones/react-native-readium",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dr-33-m/react-native-readium.git",
+    "directory": ".",
+    "branch": "open-citadel-main"
+  },
   "author": "Jacob Spizziri <jspizziri@weare5stones.com> (https://github.com/jspizziri)",
   "license": "MIT",
   "bugs": {
@@ -191,4 +196,4 @@
   },
   "packageManager": "yarn@3.6.4",
   "stableVersion": "1.2.1"
-}
+}