@quran.ws/qvp-react-native 0.8.0 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,10 +1,13 @@
1
1
  # @quran.ws/qvp-react-native
2
2
 
3
- React Native wrapper for the QVP vector mushaf engine. Android-first: a native view
4
- (`<QvpPageView />`) hosting the Kotlin library's `QvpPageView` (`ws.quran.qvp`,
5
- `packages/android/qvp`, JNI over `crates/qvp-ffi/include/qvp.h`) plus a promise-based module
6
- (`QvpModule`) for queries. The wrapper is *thin*: no hit-testing, layout or styling logic in JS or
7
- in the module — it marshals props/targets/selectors and reconciles declarative arrays against engine
3
+ React Native wrapper for the QVP vector mushaf engine, on Android and iOS. Each platform has
4
+ a native view (`<QvpPageView />`) and a promise-based module (`QvpModule`) for queries. On
5
+ Android the view hosts the Kotlin library's `QvpPageView` (`ws.quran.qvp`,
6
+ `packages/android/qvp`, JNI over `crates/qvp-ffi/include/qvp.h`). On iOS it hosts QvpKit's
7
+ `QvpPageView` (`packages/ios/QvpKit`, Swift over the same header). The two modules have the
8
+ same method names and give the same result shapes, so the JavaScript side has no platform
9
+ branch. The wrapper is *thin*: no hit-testing, layout or styling logic in JS or in the
10
+ module — it marshals props/targets/selectors and reconciles declarative arrays against engine
8
11
  handles. Names follow `docs/API.md`. **The package ships no page data.**
9
12
 
10
13
  ## Install
@@ -13,26 +16,60 @@ handles. Names follow `docs/API.md`. **The package ships no page data.**
13
16
  npm install @quran.ws/qvp-react-native # or a file:/git dependency inside the monorepo
14
17
  ```
15
18
 
16
- Android needs the Kotlin library. Preferred: include it as a Gradle project in your app's
17
- `android/settings.gradle` (this is what `../example` does):
19
+ Android needs the Kotlin library `ws.quran.qvp`. The module finds it in one of three ways,
20
+ and the first that applies wins:
18
21
 
19
- ```groovy
20
- include ':qvp'
21
- project(':qvp').projectDir = file('<repo>/packages/android/qvp') // e.g. '../../../android/qvp'
22
- ```
22
+ 1. Your app's `android/settings.gradle` includes the library as the Gradle project `:qvp`.
23
+ The module then depends on `project(':qvp')`. `../example` does this:
24
+
25
+ ```groovy
26
+ include ':qvp'
27
+ project(':qvp').projectDir = file('<repo>/packages/android/qvp') // e.g. '../../../android/qvp'
28
+ ```
29
+
30
+ 2. The Gradle property `qvpAndroidDir` names a checkout of `packages/android/qvp`. The module
31
+ compiles the library's Kotlin and JNI sources from that folder.
32
+ 3. Otherwise the module depends on `ws.quran:qvp-android` from Maven Central, at the version
33
+ of this package. An app that installs the package from npm needs nothing more. To use a
34
+ different library version, set the Gradle property `qvpVersion`, for example
35
+ `qvpVersion=0.9.0` in `android/gradle.properties`.
36
+
37
+ The Maven Central library holds the engine. In ways 1 and 2 the engine comes from
38
+ `packages/android/qvp/prebuilt/<abi>/libqvp_ffi.a`. Make it once with
39
+ `scripts/build-engine-android.sh` from the repository root.
40
+
41
+ iOS needs CocoaPods. React Native's autolinking finds `qvp-react-native.podspec`, so run
42
+ `pod install` in your app's `ios` folder after `npm install`. The pod compiles QvpKit's Swift
43
+ sources with the module and links the engine, `QvpEngine.xcframework`. It takes the engine in
44
+ one of three ways, and the first that applies wins:
45
+
46
+ 1. Inside this repository, as `../example` does, the pod takes the XCFramework that
47
+ `scripts/build-engine-ios.sh` writes at `packages/ios/QvpKit/QvpEngine.xcframework`. It
48
+ copies QvpKit's sources from `packages/ios/QvpKit` at each `pod install`, so run
49
+ `pod install` again after you change them.
50
+ 2. The environment variable `QVP_ENGINE_XCFRAMEWORK` names an XCFramework to link, for
51
+ example an engine that you built yourself:
23
52
 
24
- The module then depends on `project(':qvp')`. If `:qvp` is not included, the module compiles the
25
- library's Kotlin + JNI sources itself from `qvpAndroidDir` (Gradle property; default
26
- `../../../android/qvp`, right for the monorepo). Either way the engine comes from
27
- `packages/android/qvp/prebuilt/<abi>/libqvp_ffi.a` — produce it once with
28
- `scripts/build-engine-android.sh` from the repo root.
53
+ ```sh
54
+ QVP_ENGINE_XCFRAMEWORK=/path/to/QvpEngine.xcframework pod install
55
+ ```
56
+
57
+ 3. Otherwise `pod install` downloads the XCFramework of this package's release from GitHub,
58
+ the one that SwiftPM takes for QvpKit, and checks its SHA-256 checksum. An app that
59
+ installs the package from npm needs nothing more. The download needs `curl` and `unzip`.
60
+
61
+ The pod and QvpKit through SwiftPM each link the engine. Do not use both in one app: the
62
+ engine's C symbols would be defined twice.
29
63
 
30
64
  Requirements: RN ≥ 0.76 (legacy view manager / native module through the interop layer, verified on
31
- 0.87 with the New Architecture), minSdk 24, NDK 27, CMake 3.22.
65
+ 0.87 with the New Architecture). Android: minSdk 24, and ways 1 and 2 also need NDK 27 and
66
+ CMake 3.22. iOS: iOS 15.1, CocoaPods and Xcode 16.
32
67
 
33
68
  Page data: `cargo run -p qvp-convert --release -- batch pages dist/pages` → `NNN.qvp`,
34
69
  `NNN.words.json`, `atlas.qva`. Put them wherever you like (assets, files dir, downloads) and pass
35
- URIs: `asset://pages/042.qvp`, `file:///…`, `/abs/path`, or `base64:…`.
70
+ URIs: `asset://pages/042.qvp`, `file:///…`, `/abs/path`, or `base64:…`. On iOS an `asset://`
71
+ URI names a file in the app bundle: `asset://pages/042.qvp` is `pages/042.qvp` under the
72
+ bundle's resources, for example a folder reference named `pages`.
36
73
 
37
74
  ## The view
38
75
 
@@ -80,7 +117,7 @@ Reconciliation: each `highlights` entry maps to one engine handle. A new id →
80
117
  changes (`null` → `revealStop`). When `pageUri` changes, the old page is freed and every declarative
81
118
  prop is re-applied to the new page.
82
119
 
83
- Gestures are the Kotlin view's: tap → gap-aware `hitTestView` → `onWordTap` / `onDecorationTap` /
120
+ Gestures are the native view's (Kotlin or QvpKit): tap → gap-aware `hitTestView` → `onWordTap` / `onDecorationTap` /
84
121
  `onEmptyTap`; long-press-drag → engine `select` with a band in `LAYER.SELECTION`; pinch / pan;
85
122
  double-tap resets. Props `selectionEnabled`, `zoomEnabled`, `hitMaxDistance`, `selectionBand`.
86
123
 
@@ -146,7 +183,7 @@ await qvp.search('الرحمان', { mode: 'includes' }); // [{word, wordKey
146
183
  await qvp.text('2:255', { form: 'search', wordSep: ' ' });
147
184
  await qvp.targetWords('line:7'); qvp.findWord(2, 255, 3); qvp.wordForm(i, 'rasm_imlai'); qvp.hasForm('qpc');
148
185
  await qvp.attachWords(jsonString); // when you do not use the wordsUri prop
149
- await qvp.surahs(); qvp.divisions(); qvp.ayahMarks(); qvp.rosettes(); qvp.sajdahs(); qvp.ayahKeys();
186
+ await qvp.surahs(); qvp.divisions(); qvp.ayahMarks(); qvp.ayahMarksView(); qvp.rosettes(); qvp.sajdahs(); qvp.ayahKeys();
150
187
  await qvp.ayahWordCount(2, 255); qvp.reciteMap(2, 255, 4); qvp.wordLabel(i); qvp.ayahLabel(ayahIndex);
151
188
  await qvp.citation([12, 13, 14]);
152
189
  await qvp.cropSvg('2:255', { pad: 3, keepMarkers: true, background: '#fffdf7' }); qvp.cropBounds(target);
@@ -169,13 +206,18 @@ await atlas.pagesOfJuz(30); atlas.searchSurahs('cow' | 'البقرة' | '2'); at
169
206
  // tag-level equivalents: Qvp.atlasPageOf(id, s, a), Qvp.atlasSearchSurahs(id, text), Qvp.atlasPagesOfJuz(id, n), Qvp.atlasJuzOf(id, s, a), …
170
207
  ```
171
208
 
172
- The module runs a call on one of two threads. Its own query thread runs each call that reads only
209
+ On iOS, a view method takes and returns points, where Android takes dp.
210
+
211
+ `layoutLineSpacingToFill`, `layoutWastedFraction` and `layoutPrintedHeight` measure the
212
+ printed page. Both platforms pass the engine the view's spec before the reader's zoom.
213
+
214
+ The module runs a call on one of two threads (on iOS, two queues). Its own query thread runs each call that reads only
173
215
  what a page fixed when it loaded: `info`, `words`, `word`, `ayahs`, `lines`, `decorations`, `findWord`,
174
- `targetWords`, `wordForm`, `hasForm`, the metadata calls except `surahHeaders` and `surahHeadersView`,
175
- `text`, `search`, `citation`, `cropBounds`, `grid`, the engine-wide helpers and the atlas. A long call
176
- there does not hold up a frame. The view keeps its page open until such a call returns. Every other
177
- call reads or changes the layout, the view, the styles or the page state, and runs on the UI thread,
178
- where the view draws. `attachWords` runs on the UI thread after the queries queued before it, and the
216
+ `targetWords`, `wordForm`, `hasForm`, the metadata calls except `surahHeaders`, `surahHeadersView`
217
+ and `ayahMarksView`, `text`, `search`, `citation`, `cropBounds`, `grid`, the engine-wide helpers and
218
+ the atlas. A long call there does not hold up a frame. The view keeps its page open until such a call returns. Every other
219
+ call reads or changes the layout, the view, the styles or the page state, and runs on the UI thread
220
+ (the main thread on iOS), where the view draws. `attachWords` runs on the UI thread after the queries queued before it, and the
179
221
  queries queued after it wait for it.
180
222
 
181
223
  `words` builds each word's record once per page: its forms, its label and the names of its paths.
@@ -196,15 +238,16 @@ android/src/main/java/ws/quran/qvp/rn/
196
238
  QvpRnWords.kt each word's record, built once per page
197
239
  Codes.kt QVP_TARGET_* and QVP_SELECTOR_* by name (scripts/gen-rn-enums.py writes it)
198
240
  QvpPackage.kt
241
+ qvp-react-native.podspec the iOS pod: the module, QvpKit's sources and QvpEngine.xcframework
242
+ ios/
243
+ QvpModule.m what React Native sees: the module's methods, the two view managers' props and events
244
+ QvpModule.swift the module over QvpKit, with the method names of QvpModule.kt
245
+ QvpRnPageView.swift hosts QvpKit's QvpPageView: page loading, prop → handle reconciliation, events
246
+ QvpRnPassageView.swift loads the pages, lays the passage out at the view's width, draws it, reports the layout
247
+ QvpRnMarshal.swift JS shapes ↔ QvpKit types, key for key as Marshal.kt
248
+ QvpRnBytes.swift the bytes a URI names, and each word's record, built once per page
249
+ QvpRnCodes.swift QVP_TARGET_* and QVP_SELECTOR_* by name (scripts/gen-rn-enums.py writes it)
250
+ vendor-qvpkit.sh copies QvpKit's sources and the XCFramework's URL and checksum into ios/vendor (prepack)
199
251
  src/index.tsx typed API: <QvpPageView/>, <QvpPassageView/>, useQvp(), Qvp, QvpAtlas, QvpOrnaments, Sel, T, constants
200
252
  src/codes.ts the same codes for T and Sel (scripts/gen-rn-enums.py writes it)
201
253
  ```
202
-
203
- ## iOS — TODO
204
-
205
- Not implemented (no macOS in the build environment). The iOS side mirrors the Android module over the
206
- same `qvp.h`: a Swift `QvpPage`/`QvpAtlas` over `libqvp_ffi.a` (build with
207
- `cargo build -p qvp-ffi --profile dist --target aarch64-apple-ios[-sim]`), a `UIView` renderer with the
208
- same draw order (highlight bands → cached base ink → styled ink → mask boxes, `tick(now)` per
209
- `CADisplayLink` frame), an `RCTViewManager` exposing the props above with the same reconciliation, and
210
- an `RCTBridgeModule` with the same method names. `src/index.tsx` needs no changes.
@@ -1,12 +1,16 @@
1
1
  // @quran.ws/qvp-react-native — Android module. Thin: marshalling + handle reconciliation over the Kotlin
2
2
  // library `ws.quran.qvp` (packages/android/qvp), which is JNI over crates/qvp-ffi/include/qvp.h.
3
3
  //
4
- // Linking the Kotlin library, two ways:
5
- // 1. (preferred) the app's settings.gradle includes it as a Gradle project:
4
+ // The module links the Kotlin library in one of three ways. The first that applies wins:
5
+ // 1. The app's settings.gradle includes the library as the Gradle project `:qvp`:
6
6
  // include(":qvp"); project(":qvp").projectDir = file("<repo>/packages/android/qvp")
7
- // and this module depends on `project(":qvp")`.
8
- // 2. otherwise this module compiles the library's Kotlin + JNI sources straight from `qvpAndroidDir`
9
- // (gradle property; default: ../../../android/qvp inside the monorepo). Same code, one AAR.
7
+ // The module then depends on `project(":qvp")`. The example in this repository does this.
8
+ // 2. The Gradle property `qvpAndroidDir` names a checkout of packages/android/qvp. The module
9
+ // compiles the library's Kotlin and JNI sources from that folder.
10
+ // 3. Otherwise the module depends on `ws.quran:qvp-android` from Maven Central. This is the
11
+ // way for an app that installs the package from npm. The version is the version in this
12
+ // package's package.json, so the two stay in step. The Gradle property `qvpVersion` sets
13
+ // a different version.
10
14
  buildscript {
11
15
  if (project == rootProject) {
12
16
  repositories { google(); mavenCentral() }
@@ -22,19 +26,22 @@ apply plugin: "org.jetbrains.kotlin.android"
22
26
 
23
27
  def safeExtGet(prop, fallback) { rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback }
24
28
  def qvpProject = findProject(":qvp")
25
- def qvpDir = file(rootProject.findProperty("qvpAndroidDir") ?: "$projectDir/../../../android/qvp")
29
+ def qvpAndroidDir = rootProject.findProperty("qvpAndroidDir")
30
+ def qvpDir = qvpProject == null && qvpAndroidDir != null ? file(qvpAndroidDir) : null
31
+ def qvpVersion = rootProject.findProperty("qvpVersion") ?:
32
+ new groovy.json.JsonSlurper().parse(file("$projectDir/../package.json")).version
26
33
 
27
34
  android {
28
35
  namespace "ws.quran.qvp.rn"
29
36
  compileSdk safeExtGet("compileSdkVersion", 35)
30
37
  defaultConfig {
31
38
  minSdkVersion safeExtGet("minSdkVersion", 24)
32
- if (qvpProject == null) {
39
+ if (qvpDir != null) {
33
40
  externalNativeBuild { cmake { arguments "-DANDROID_STL=none" } }
34
41
  ndk { abiFilters "arm64-v8a", "x86_64", "armeabi-v7a" }
35
42
  }
36
43
  }
37
- if (qvpProject == null) {
44
+ if (qvpDir != null) {
38
45
  ndkVersion safeExtGet("ndkVersion", "27.2.12479018")
39
46
  externalNativeBuild { cmake { path file("$qvpDir/src/main/cpp/CMakeLists.txt"); version "3.22.1" } }
40
47
  sourceSets { main { kotlin.srcDirs += "$qvpDir/src/main/kotlin"; java.srcDirs += "$qvpDir/src/main/kotlin" } }
@@ -50,5 +57,6 @@ dependencies {
50
57
  // version pinned by the React Native Gradle Plugin of the consuming app
51
58
  implementation "com.facebook.react:react-android"
52
59
  if (qvpProject != null) implementation project(":qvp")
60
+ else if (qvpDir == null) implementation "ws.quran:qvp-android:$qvpVersion"
53
61
  testImplementation "junit:junit:4.13.2"
54
62
  }
@@ -104,6 +104,7 @@ class QvpModule(private val ctx: ReactApplicationContext) : ReactContextBaseJava
104
104
  @ReactMethod fun surahHeaders(tag: Int, promise: Promise) = withPage(tag, promise) { _, p -> p.surahHeaders().map { Marshal.surahHeader(it) } }
105
105
  @ReactMethod fun surahHeadersView(tag: Int, promise: Promise) = withPage(tag, promise) { _, p -> p.surahHeadersView().map { Marshal.surahHeader(it) } }
106
106
  @ReactMethod fun ayahMarks(tag: Int, promise: Promise) = readPage(tag, promise) { _, p -> p.ayahMarks().map { Marshal.ayahMark(it) } }
107
+ @ReactMethod fun ayahMarksView(tag: Int, promise: Promise) = withPage(tag, promise) { _, p -> p.ayahMarksView().map { Marshal.ayahMark(it) } }
107
108
  @ReactMethod fun rosettes(tag: Int, promise: Promise) = readPage(tag, promise) { _, p -> p.rosettes().map { Marshal.rosette(it) } }
108
109
  @ReactMethod fun sajdahs(tag: Int, promise: Promise) = readPage(tag, promise) { _, p -> p.sajdahs().map { Marshal.sajdah(it) } }
109
110
  @ReactMethod fun ayahKeys(tag: Int, promise: Promise) = readPage(tag, promise) { _, p -> p.ayahKeys().map { mapOf("surah" to it.first, "ayah" to it.second, "ayahKey" to "${it.first}:${it.second}") } }
@@ -0,0 +1,167 @@
1
+ // @quran.ws/qvp-react-native, iOS. What React Native sees of the module and the two views: the
2
+ // module's methods (QvpModule.swift implements them) and the views' props and events. The names
3
+ // are those of the Android module, so src/index.tsx has no platform branch.
4
+ #import <React/RCTBridgeModule.h>
5
+ #import <React/RCTViewManager.h>
6
+
7
+ @interface RCT_EXTERN_MODULE(QvpModule, NSObject)
8
+ RCT_EXTERN_METHOD(info:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
9
+ RCT_EXTERN_METHOD(words:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
10
+ RCT_EXTERN_METHOD(word:(nonnull NSNumber *)tag index:(nonnull NSNumber *)index resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
11
+ RCT_EXTERN_METHOD(ayahs:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
12
+ RCT_EXTERN_METHOD(lines:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
13
+ RCT_EXTERN_METHOD(decorations:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
14
+ RCT_EXTERN_METHOD(findWord:(nonnull NSNumber *)tag s:(nonnull NSNumber *)s a:(nonnull NSNumber *)a w:(nonnull NSNumber *)w resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
15
+ RCT_EXTERN_METHOD(targetWords:(nonnull NSNumber *)tag target:(id)target resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
16
+ RCT_EXTERN_METHOD(wordForm:(nonnull NSNumber *)tag index:(nonnull NSNumber *)index form:(NSString *)form resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
17
+ RCT_EXTERN_METHOD(hasForm:(nonnull NSNumber *)tag form:(NSString *)form resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
18
+ RCT_EXTERN_METHOD(attachWords:(nonnull NSNumber *)tag json:(NSString *)json resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
19
+ RCT_EXTERN_METHOD(surahs:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
20
+ RCT_EXTERN_METHOD(divisions:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
21
+ RCT_EXTERN_METHOD(surahHeaders:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
22
+ RCT_EXTERN_METHOD(surahHeadersView:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
23
+ RCT_EXTERN_METHOD(ayahMarks:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
24
+ RCT_EXTERN_METHOD(ayahMarksView:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
25
+ RCT_EXTERN_METHOD(rosettes:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
26
+ RCT_EXTERN_METHOD(sajdahs:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
27
+ RCT_EXTERN_METHOD(ayahKeys:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
28
+ RCT_EXTERN_METHOD(ayahWordCount:(nonnull NSNumber *)tag s:(nonnull NSNumber *)s a:(nonnull NSNumber *)a resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
29
+ RCT_EXTERN_METHOD(reciteMap:(nonnull NSNumber *)tag s:(nonnull NSNumber *)s a:(nonnull NSNumber *)a n:(nonnull NSNumber *)n resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
30
+ RCT_EXTERN_METHOD(wordLabel:(nonnull NSNumber *)tag i:(nonnull NSNumber *)i resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
31
+ RCT_EXTERN_METHOD(ayahLabel:(nonnull NSNumber *)tag i:(nonnull NSNumber *)i resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
32
+ RCT_EXTERN_METHOD(text:(nonnull NSNumber *)tag target:(id)target opts:(NSDictionary *)opts resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
33
+ RCT_EXTERN_METHOD(search:(nonnull NSNumber *)tag query:(NSString *)query opts:(NSDictionary *)opts resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
34
+ RCT_EXTERN_METHOD(citation:(nonnull NSNumber *)tag words:(NSArray *)words resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
35
+ RCT_EXTERN_METHOD(arabic:(NSString *)op s:(NSString *)s resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
36
+ RCT_EXTERN_METHOD(hitTestExact:(nonnull NSNumber *)tag x:(nonnull NSNumber *)x y:(nonnull NSNumber *)y resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
37
+ RCT_EXTERN_METHOD(hitTest:(nonnull NSNumber *)tag x:(nonnull NSNumber *)x y:(nonnull NSNumber *)y opts:(NSDictionary *)opts resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
38
+ RCT_EXTERN_METHOD(hitTestExactView:(nonnull NSNumber *)tag x:(nonnull NSNumber *)x y:(nonnull NSNumber *)y resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
39
+ RCT_EXTERN_METHOD(hitTestView:(nonnull NSNumber *)tag x:(nonnull NSNumber *)x y:(nonnull NSNumber *)y opts:(NSDictionary *)opts resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
40
+ RCT_EXTERN_METHOD(wordBoundsView:(nonnull NSNumber *)tag i:(nonnull NSNumber *)i resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
41
+ RCT_EXTERN_METHOD(currentLayout:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
42
+ RCT_EXTERN_METHOD(relayout:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
43
+ RCT_EXTERN_METHOD(resetView:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
44
+ RCT_EXTERN_METHOD(layoutLineSpacingToFill:(nonnull NSNumber *)tag max:(nonnull NSNumber *)max resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
45
+ RCT_EXTERN_METHOD(layoutWastedFraction:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
46
+ RCT_EXTERN_METHOD(layoutPrintedHeight:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
47
+ RCT_EXTERN_METHOD(grid:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
48
+ RCT_EXTERN_METHOD(stats:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
49
+ RCT_EXTERN_METHOD(invalidate:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
50
+ RCT_EXTERN_METHOD(select:(nonnull NSNumber *)tag anchor:(nonnull NSNumber *)anchor focus:(nonnull NSNumber *)focus resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
51
+ RCT_EXTERN_METHOD(clearSelection:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
52
+ RCT_EXTERN_METHOD(selection:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
53
+ RCT_EXTERN_METHOD(selectionText:(nonnull NSNumber *)tag form:(NSString *)form includeCitation:(BOOL)includeCitation resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
54
+ RCT_EXTERN_METHOD(unmaskNext:(nonnull NSNumber *)tag n:(nonnull NSNumber *)n resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
55
+ RCT_EXTERN_METHOD(maskBack:(nonnull NSNumber *)tag n:(nonnull NSNumber *)n resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
56
+ RCT_EXTERN_METHOD(unmaskWord:(nonnull NSNumber *)tag i:(nonnull NSNumber *)i resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
57
+ RCT_EXTERN_METHOD(maskWord:(nonnull NSNumber *)tag i:(nonnull NSNumber *)i resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
58
+ RCT_EXTERN_METHOD(unmaskAll:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
59
+ RCT_EXTERN_METHOD(maskAll:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
60
+ RCT_EXTERN_METHOD(maskHidden:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
61
+ RCT_EXTERN_METHOD(maskWords:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
62
+ RCT_EXTERN_METHOD(revealStepCount:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
63
+ RCT_EXTERN_METHOD(revealPosition:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
64
+ RCT_EXTERN_METHOD(revealStepOf:(nonnull NSNumber *)tag i:(nonnull NSNumber *)i resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
65
+ RCT_EXTERN_METHOD(cropBounds:(nonnull NSNumber *)tag target:(id)target opts:(NSDictionary *)opts resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
66
+ RCT_EXTERN_METHOD(cropSvg:(nonnull NSNumber *)tag target:(id)target opts:(NSDictionary *)opts resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
67
+ RCT_EXTERN_METHOD(loadAtlas:(NSString *)uri resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
68
+ RCT_EXTERN_METHOD(freeAtlas:(nonnull NSNumber *)id resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
69
+ RCT_EXTERN_METHOD(atlasPageOf:(nonnull NSNumber *)id s:(nonnull NSNumber *)s a:(nonnull NSNumber *)a resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
70
+ RCT_EXTERN_METHOD(atlasPageRange:(nonnull NSNumber *)id page:(nonnull NSNumber *)page resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
71
+ RCT_EXTERN_METHOD(atlasPageCount:(nonnull NSNumber *)id resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
72
+ RCT_EXTERN_METHOD(atlasSurah:(nonnull NSNumber *)id n:(nonnull NSNumber *)n resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
73
+ RCT_EXTERN_METHOD(atlasSurahs:(nonnull NSNumber *)id resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
74
+ RCT_EXTERN_METHOD(atlasPageOfSurah:(nonnull NSNumber *)id n:(nonnull NSNumber *)n resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
75
+ RCT_EXTERN_METHOD(atlasDivision:(nonnull NSNumber *)id division:(NSString *)division n:(nonnull NSNumber *)n resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
76
+ RCT_EXTERN_METHOD(atlasDivisionOf:(nonnull NSNumber *)id division:(NSString *)division s:(nonnull NSNumber *)s a:(nonnull NSNumber *)a resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
77
+ RCT_EXTERN_METHOD(atlasJuzOf:(nonnull NSNumber *)id s:(nonnull NSNumber *)s a:(nonnull NSNumber *)a resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
78
+ RCT_EXTERN_METHOD(atlasPagesOfJuz:(nonnull NSNumber *)id n:(nonnull NSNumber *)n resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
79
+ RCT_EXTERN_METHOD(atlasSearchSurahs:(nonnull NSNumber *)id text:(NSString *)text resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
80
+ RCT_EXTERN_METHOD(loadOrnaments:(NSString *)uri resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
81
+ RCT_EXTERN_METHOD(freeOrnaments:(nonnull NSNumber *)id resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
82
+ RCT_EXTERN_METHOD(ornamentCount:(nonnull NSNumber *)id resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
83
+ RCT_EXTERN_METHOD(ornamentInfo:(nonnull NSNumber *)id index:(nonnull NSNumber *)index resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
84
+ RCT_EXTERN_METHOD(ornamentPart:(nonnull NSNumber *)id index:(nonnull NSNumber *)index part:(nonnull NSNumber *)part resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
85
+ RCT_EXTERN_METHOD(ornamentList:(nonnull NSNumber *)id resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
86
+ RCT_EXTERN_METHOD(ornamentFind:(nonnull NSNumber *)id kind:(NSString *)kind style:(NSString *)style resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
87
+ RCT_EXTERN_METHOD(dress:(nonnull NSNumber *)tag id:(nonnull NSNumber *)id spec:(NSDictionary *)spec resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
88
+ RCT_EXTERN_METHOD(undress:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
89
+ RCT_EXTERN_METHOD(dressClamp:(nonnull NSNumber *)tag scale:(nonnull NSNumber *)scale offsetX:(nonnull NSNumber *)offsetX offsetY:(nonnull NSNumber *)offsetY viewportW:(nonnull NSNumber *)viewportW viewportH:(nonnull NSNumber *)viewportH resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
90
+ RCT_EXTERN_METHOD(dressView:(nonnull NSNumber *)tag scale:(nonnull NSNumber *)scale viewportW:(nonnull NSNumber *)viewportW resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
91
+ RCT_EXTERN_METHOD(dressInfo:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
92
+ RCT_EXTERN_METHOD(dressRevision:(nonnull NSNumber *)tag resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
93
+ RCT_EXTERN_METHOD(markName:(nonnull NSNumber *)m resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
94
+ RCT_EXTERN_METHOD(markFromName:(NSString *)s resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
95
+ RCT_EXTERN_METHOD(markCategory:(nonnull NSNumber *)m resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
96
+ RCT_EXTERN_METHOD(engineName:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
97
+ @end
98
+
99
+ /// `<QvpPageView />`: props go onto QvpRnPageView, which applies each batch in one pass.
100
+ @interface QvpPageViewManager : RCTViewManager
101
+ @end
102
+
103
+ @implementation QvpPageViewManager
104
+ RCT_EXPORT_MODULE()
105
+ - (UIView *)view { return [[NSClassFromString(@"QvpRnPageView") alloc] initWithFrame:CGRectZero]; }
106
+ RCT_EXPORT_VIEW_PROPERTY(pageUri, NSString)
107
+ RCT_EXPORT_VIEW_PROPERTY(pageBase64, NSString)
108
+ RCT_EXPORT_VIEW_PROPERTY(wordsUri, NSString)
109
+ RCT_EXPORT_VIEW_PROPERTY(padTop, CGFloat)
110
+ RCT_EXPORT_VIEW_PROPERTY(padBottom, CGFloat)
111
+ RCT_EXPORT_VIEW_PROPERTY(padSide, CGFloat)
112
+ RCT_EXPORT_VIEW_PROPERTY(lineSpacing, CGFloat)
113
+ RCT_EXPORT_VIEW_PROPERTY(reflowBreaks, NSString)
114
+ RCT_EXPORT_VIEW_PROPERTY(fillHeight, BOOL)
115
+ RCT_EXPORT_VIEW_PROPERTY(surahFrames, BOOL)
116
+ RCT_EXPORT_VIEW_PROPERTY(paperColor, NSString)
117
+ RCT_EXPORT_VIEW_PROPERTY(defaultInk, NSString)
118
+ RCT_EXPORT_VIEW_PROPERTY(selectionBand, NSString)
119
+ RCT_EXPORT_VIEW_PROPERTY(selectionEnabled, BOOL)
120
+ RCT_EXPORT_VIEW_PROPERTY(zoomEnabled, BOOL)
121
+ RCT_EXPORT_VIEW_PROPERTY(zoomMode, NSString)
122
+ RCT_EXPORT_VIEW_PROPERTY(zoomStep, NSInteger)
123
+ RCT_EXPORT_VIEW_PROPERTY(hitMaxDistance, CGFloat)
124
+ RCT_EXPORT_VIEW_PROPERTY(theme, NSDictionary)
125
+ RCT_EXPORT_VIEW_PROPERTY(styles, NSArray)
126
+ RCT_EXPORT_VIEW_PROPERTY(highlights, NSArray)
127
+ RCT_REMAP_VIEW_PROPERTY(mask, maskProp, NSDictionary)
128
+ RCT_EXPORT_VIEW_PROPERTY(reveal, NSDictionary)
129
+ RCT_EXPORT_VIEW_PROPERTY(dress, NSDictionary)
130
+ RCT_EXPORT_VIEW_PROPERTY(onWordTap, RCTDirectEventBlock)
131
+ RCT_EXPORT_VIEW_PROPERTY(onDecorationTap, RCTDirectEventBlock)
132
+ RCT_EXPORT_VIEW_PROPERTY(onEmptyTap, RCTDirectEventBlock)
133
+ RCT_EXPORT_VIEW_PROPERTY(onSelectionChanged, RCTDirectEventBlock)
134
+ RCT_EXPORT_VIEW_PROPERTY(onPageLoad, RCTDirectEventBlock)
135
+ RCT_EXPORT_VIEW_PROPERTY(onRevealChanged, RCTDirectEventBlock)
136
+ RCT_EXPORT_VIEW_PROPERTY(onSwipe, RCTDirectEventBlock)
137
+ RCT_EXPORT_VIEW_PROPERTY(onZoomChanged, RCTDirectEventBlock)
138
+ RCT_EXPORT_VIEW_PROPERTY(onDressChanged, RCTDirectEventBlock)
139
+ RCT_EXPORT_VIEW_PROPERTY(onError, RCTDirectEventBlock)
140
+ @end
141
+
142
+ /// `<QvpPassageView />`: props go onto QvpRnPassageView, which applies each batch in one pass.
143
+ @interface QvpPassageViewManager : RCTViewManager
144
+ @end
145
+
146
+ @implementation QvpPassageViewManager
147
+ RCT_EXPORT_MODULE()
148
+ - (UIView *)view { return [[NSClassFromString(@"QvpRnPassageView") alloc] initWithFrame:CGRectZero]; }
149
+ RCT_EXPORT_VIEW_PROPERTY(pageUris, NSStringArray)
150
+ RCT_EXPORT_VIEW_PROPERTY(surah, NSInteger)
151
+ RCT_EXPORT_VIEW_PROPERTY(from, NSInteger)
152
+ RCT_EXPORT_VIEW_PROPERTY(to, NSInteger)
153
+ RCT_EXPORT_VIEW_PROPERTY(basmalah, BOOL)
154
+ RCT_EXPORT_VIEW_PROPERTY(scale, CGFloat)
155
+ RCT_EXPORT_VIEW_PROPERTY(lineHeight, CGFloat)
156
+ RCT_EXPORT_VIEW_PROPERTY(lineSpacing, CGFloat)
157
+ RCT_EXPORT_VIEW_PROPERTY(padding, CGFloat)
158
+ RCT_EXPORT_VIEW_PROPERTY(align, NSString)
159
+ RCT_EXPORT_VIEW_PROPERTY(maxRows, NSInteger)
160
+ RCT_EXPORT_VIEW_PROPERTY(keepAyahMark, BOOL)
161
+ RCT_EXPORT_VIEW_PROPERTY(ellipsisWidth, CGFloat)
162
+ RCT_EXPORT_VIEW_PROPERTY(maxStretch, CGFloat)
163
+ RCT_EXPORT_VIEW_PROPERTY(ink, NSString)
164
+ RCT_EXPORT_VIEW_PROPERTY(paperColor, NSString)
165
+ RCT_EXPORT_VIEW_PROPERTY(onPassageLayout, RCTDirectEventBlock)
166
+ RCT_EXPORT_VIEW_PROPERTY(onError, RCTDirectEventBlock)
167
+ @end