@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 +78 -35
- package/android/build.gradle +16 -8
- package/android/src/main/java/ws/quran/qvp/rn/QvpModule.kt +1 -0
- package/ios/QvpModule.m +167 -0
- package/ios/QvpModule.swift +508 -0
- package/ios/QvpRnBytes.swift +66 -0
- package/ios/QvpRnCodes.swift +33 -0
- package/ios/QvpRnMarshal.swift +360 -0
- package/ios/QvpRnPageView.swift +467 -0
- package/ios/QvpRnPassageView.swift +160 -0
- package/ios/vendor/QvpEngine.json +4 -0
- package/ios/vendor/QvpKit/QvpDress.swift +390 -0
- package/ios/vendor/QvpKit/QvpEngine.swift +55 -0
- package/ios/vendor/QvpKit/QvpPage.swift +469 -0
- package/ios/vendor/QvpKit/QvpPageCache.swift +176 -0
- package/ios/vendor/QvpKit/QvpPageCanvas.swift +1031 -0
- package/ios/vendor/QvpKit/QvpPageView.swift +711 -0
- package/ios/vendor/QvpKit/QvpPassage.swift +240 -0
- package/ios/vendor/QvpKit/QvpViewPolicy.swift +26 -0
- package/ios/vendor/QvpKit/QvpZoom.swift +200 -0
- package/ios/vendor/QvpKit/QvpZoomSpring.swift +22 -0
- package/ios/vendor/QvpKit/Types.swift +440 -0
- package/ios/vendor-qvpkit.sh +36 -0
- package/package.json +10 -3
- package/qvp-react-native.podspec +97 -0
- package/src/index.tsx +86 -10
|
@@ -0,0 +1,508 @@
|
|
|
1
|
+
// @quran.ws/qvp-react-native, iOS. The native module over QvpKit.
|
|
2
|
+
import Foundation
|
|
3
|
+
import UIKit
|
|
4
|
+
import React
|
|
5
|
+
|
|
6
|
+
/// Promise-based queries on the page behind a `<QvpPageView />` (looked up by react tag), plus
|
|
7
|
+
/// engine-wide helpers, the atlas and the ornament sets. The method names, arguments and result
|
|
8
|
+
/// shapes are those of android/.../QvpModule.kt, so src/index.tsx has no platform branch. Names
|
|
9
|
+
/// follow docs/API.md. QvpModule.m declares the methods to React Native.
|
|
10
|
+
///
|
|
11
|
+
/// Two queues run the calls. The query queue, which this module owns, runs every call that reads
|
|
12
|
+
/// only what a page fixed when it loaded: its words, ayahs, lines, text, search, metadata and crop
|
|
13
|
+
/// box. It also runs the engine-wide helpers and owns the atlases. A long query on it does not
|
|
14
|
+
/// hold up a frame. The view keeps the page open while a query reads it (`QvpRnPageView.read`).
|
|
15
|
+
/// Every call that reads or changes the layout, the view, styles, colours, the selection, the
|
|
16
|
+
/// mask, the reveal or the dress runs on the main thread, where the view draws.
|
|
17
|
+
///
|
|
18
|
+
/// The view methods take and return points, the iOS form of the dp the Android module uses.
|
|
19
|
+
@objc(QvpModule)
|
|
20
|
+
final class QvpModule: NSObject {
|
|
21
|
+
/// The query queue. The atlases below are touched only on it.
|
|
22
|
+
private let queries = DispatchQueue(label: "ws.quran.qvp.rn.query", qos: .userInitiated)
|
|
23
|
+
private var atlases: [Int: QvpAtlas] = [:]
|
|
24
|
+
private var atlasByUri: [String: Int] = [:]
|
|
25
|
+
private var nextAtlas = 1
|
|
26
|
+
|
|
27
|
+
@objc static func requiresMainQueueSetup() -> Bool { false }
|
|
28
|
+
|
|
29
|
+
// ── plumbing ──
|
|
30
|
+
private func settle(_ resolve: RCTPromiseResolveBlock, _ reject: RCTPromiseRejectBlock, _ block: () throws -> Any?) {
|
|
31
|
+
do { resolve(QvpRnMarshal.toJs(try block())) } catch { reject("qvp", error.localizedDescription, error) }
|
|
32
|
+
}
|
|
33
|
+
private func ui(_ resolve: @escaping RCTPromiseResolveBlock, _ reject: @escaping RCTPromiseRejectBlock, _ block: @escaping () throws -> Any?) {
|
|
34
|
+
DispatchQueue.main.async { self.settle(resolve, reject, block) }
|
|
35
|
+
}
|
|
36
|
+
/// An engine-wide call, or an atlas call, on the query queue.
|
|
37
|
+
private func off(_ resolve: @escaping RCTPromiseResolveBlock, _ reject: @escaping RCTPromiseRejectBlock, _ block: @escaping () throws -> Any?) {
|
|
38
|
+
queries.async { self.settle(resolve, reject, block) }
|
|
39
|
+
}
|
|
40
|
+
private func view(_ tag: NSNumber) throws -> QvpRnPageView {
|
|
41
|
+
guard let v = QvpRnRegistry.get(tag.intValue) else { throw QvpRnError("no QvpPageView with tag \(tag)") }
|
|
42
|
+
return v
|
|
43
|
+
}
|
|
44
|
+
private func loaded(_ v: QvpRnPageView, _ tag: NSNumber) throws -> QvpPage {
|
|
45
|
+
guard let p = v.page, p.isOpen else { throw QvpRnError("QvpPageView \(tag) has no page loaded") }
|
|
46
|
+
return p
|
|
47
|
+
}
|
|
48
|
+
/// A read-only page query on the query queue, with the page held open until it returns. The
|
|
49
|
+
/// queue sees the view's state alone, never the view. A view the registry does not hold
|
|
50
|
+
/// yet is looked up again on the main thread, after the prop batches queued there, as
|
|
51
|
+
/// Android looks it up through the UIManager, and the query runs there.
|
|
52
|
+
private func readPage(_ tag: NSNumber, _ resolve: @escaping RCTPromiseResolveBlock, _ reject: @escaping RCTPromiseRejectBlock,
|
|
53
|
+
_ block: @escaping (QvpRnPageState, QvpPage, _ loadMs: Double, _ bytes: Int) throws -> Any?) {
|
|
54
|
+
let run = { (s: QvpRnPageState) in
|
|
55
|
+
self.settle(resolve, reject) {
|
|
56
|
+
try s.read { p, ms, bytes in
|
|
57
|
+
guard let p else { throw QvpRnError("QvpPageView \(tag) has no page loaded") }
|
|
58
|
+
return try block(s, p, ms, bytes)
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
queries.async {
|
|
63
|
+
if let s = QvpRnRegistry.state(tag.intValue) { run(s); return }
|
|
64
|
+
DispatchQueue.main.async {
|
|
65
|
+
guard let s = QvpRnRegistry.state(tag.intValue) else { reject("qvp", "no QvpPageView with tag \(tag)", nil); return }
|
|
66
|
+
run(s)
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
/// A page call on the main thread that the queries queued before it see done, and that is
|
|
71
|
+
/// done before the queries queued after it start: the query queue waits for it. It holds no
|
|
72
|
+
/// page open while it waits, so the main thread never waits for it in turn.
|
|
73
|
+
private func inOrder(_ tag: NSNumber, _ resolve: @escaping RCTPromiseResolveBlock, _ reject: @escaping RCTPromiseRejectBlock,
|
|
74
|
+
_ block: @escaping (QvpRnPageView, QvpPage) throws -> Any?) {
|
|
75
|
+
queries.async {
|
|
76
|
+
DispatchQueue.main.sync {
|
|
77
|
+
self.settle(resolve, reject) { let v = try self.view(tag); return try block(v, try self.loaded(v, tag)) }
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
/// A page call on the main thread.
|
|
82
|
+
private func withPage(_ tag: NSNumber, _ resolve: @escaping RCTPromiseResolveBlock, _ reject: @escaping RCTPromiseRejectBlock,
|
|
83
|
+
_ block: @escaping (QvpRnPageView, QvpPage) throws -> Any?) {
|
|
84
|
+
ui(resolve, reject) { let v = try self.view(tag); return try block(v, try self.loaded(v, tag)) }
|
|
85
|
+
}
|
|
86
|
+
private func withAtlas(_ id: NSNumber, _ resolve: @escaping RCTPromiseResolveBlock, _ reject: @escaping RCTPromiseRejectBlock, _ block: @escaping (QvpAtlas) throws -> Any?) {
|
|
87
|
+
off(resolve, reject) {
|
|
88
|
+
guard let a = self.atlases[id.intValue] else { throw QvpRnError("no atlas \(id)") }
|
|
89
|
+
return try block(a)
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
private func withOrnaments(_ id: NSNumber, _ resolve: @escaping RCTPromiseResolveBlock, _ reject: @escaping RCTPromiseRejectBlock, _ block: @escaping (QvpOrnaments) throws -> Any?) {
|
|
93
|
+
ui(resolve, reject) {
|
|
94
|
+
guard let s = QvpOrnamentSets.get(id.intValue) else { throw QvpRnError("no ornament set \(id)") }
|
|
95
|
+
return try block(s)
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
private func opt(_ m: NSDictionary?) -> [String: Any] { (m as? [String: Any]) ?? [:] }
|
|
99
|
+
private func ints(_ a: NSArray?) -> [Int] { QvpRnMarshal.ints(a as? [Any]) }
|
|
100
|
+
private func hitOptions(_ o: [String: Any]) -> QvpHitOptions {
|
|
101
|
+
QvpHitOptions(maxDistance: QvpRnMarshal.flt(o["maxDistance"], QvpDefaults.TAP_DISTANCE), gapBias: QvpRnMarshal.flt(o["gapBias"], QvpDefaults.GAP_BIAS),
|
|
102
|
+
preferExact: !QvpRnMarshal.isFalse(o["preferExact"]))
|
|
103
|
+
}
|
|
104
|
+
private func viewOf(_ v: QvpRnPageView) -> QvpView {
|
|
105
|
+
QvpView(scale: Float(v.inner.viewScale), offsetX: Float(v.inner.viewOx), offsetY: Float(v.inner.viewOy))
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
// ── page facts ──
|
|
109
|
+
@objc func info(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
110
|
+
readPage(tag, resolve, reject) { s, p, ms, bytes in QvpRnMarshal.pageInfo(p, s.words(p).forms).merging(["loadMs": ms, "bytes": bytes]) { a, _ in a } }
|
|
111
|
+
}
|
|
112
|
+
@objc func words(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
113
|
+
readPage(tag, resolve, reject) { s, p, _, _ in s.words(p).all() }
|
|
114
|
+
}
|
|
115
|
+
@objc func word(_ tag: NSNumber, index: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
116
|
+
readPage(tag, resolve, reject) { s, p, _, _ in s.words(p).word(index.intValue) }
|
|
117
|
+
}
|
|
118
|
+
@objc func ayahs(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
119
|
+
readPage(tag, resolve, reject) { _, p, _, _ in p.ayahs.map { QvpRnMarshal.ayah($0) } }
|
|
120
|
+
}
|
|
121
|
+
@objc func lines(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
122
|
+
readPage(tag, resolve, reject) { _, p, _, _ in p.lines.map { QvpRnMarshal.line($0) } }
|
|
123
|
+
}
|
|
124
|
+
@objc func decorations(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
125
|
+
readPage(tag, resolve, reject) { _, p, _, _ in p.decorations.map { QvpRnMarshal.decoration($0) } }
|
|
126
|
+
}
|
|
127
|
+
@objc func findWord(_ tag: NSNumber, s: NSNumber, a: NSNumber, w: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
128
|
+
readPage(tag, resolve, reject) { _, p, _, _ in p.findWord(s.intValue, a.intValue, w.intValue) }
|
|
129
|
+
}
|
|
130
|
+
@objc func targetWords(_ tag: NSNumber, target: Any?, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
131
|
+
readPage(tag, resolve, reject) { _, p, _, _ in p.targetWords(QvpRnMarshal.target(target, p)) }
|
|
132
|
+
}
|
|
133
|
+
@objc func wordForm(_ tag: NSNumber, index: NSNumber, form: String?, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
134
|
+
readPage(tag, resolve, reject) { _, p, _, _ in p.wordForm(index.intValue, QvpRnMarshal.form(form)) }
|
|
135
|
+
}
|
|
136
|
+
@objc func hasForm(_ tag: NSNumber, form: String?, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
137
|
+
readPage(tag, resolve, reject) { _, p, _, _ in p.hasForm(QvpRnMarshal.form(form)) }
|
|
138
|
+
}
|
|
139
|
+
@objc func attachWords(_ tag: NSNumber, json: String, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
140
|
+
inOrder(tag, resolve, reject) { v, p in v.attachWords(p, json) }
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
// ── metadata ──
|
|
144
|
+
@objc func surahs(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
145
|
+
readPage(tag, resolve, reject) { _, p, _, _ in p.surahs().map { QvpRnMarshal.surah($0) } }
|
|
146
|
+
}
|
|
147
|
+
@objc func divisions(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
148
|
+
readPage(tag, resolve, reject) { _, p, _, _ in p.divisions().map { QvpRnMarshal.division($0) } }
|
|
149
|
+
}
|
|
150
|
+
@objc func surahHeaders(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
151
|
+
withPage(tag, resolve, reject) { _, p in p.surahHeaders().map { QvpRnMarshal.surahHeader($0) } }
|
|
152
|
+
}
|
|
153
|
+
@objc func surahHeadersView(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
154
|
+
withPage(tag, resolve, reject) { _, p in p.surahHeadersView().map { QvpRnMarshal.surahHeader($0) } }
|
|
155
|
+
}
|
|
156
|
+
@objc func ayahMarks(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
157
|
+
readPage(tag, resolve, reject) { _, p, _, _ in p.ayahMarks().map { QvpRnMarshal.ayahMark($0) } }
|
|
158
|
+
}
|
|
159
|
+
@objc func ayahMarksView(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
160
|
+
withPage(tag, resolve, reject) { _, p in p.ayahMarksView().map { QvpRnMarshal.ayahMark($0) } }
|
|
161
|
+
}
|
|
162
|
+
@objc func rosettes(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
163
|
+
readPage(tag, resolve, reject) { _, p, _, _ in p.rosettes().map { QvpRnMarshal.rosette($0) } }
|
|
164
|
+
}
|
|
165
|
+
@objc func sajdahs(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
166
|
+
readPage(tag, resolve, reject) { _, p, _, _ in p.sajdahs().map { QvpRnMarshal.sajdah($0) } }
|
|
167
|
+
}
|
|
168
|
+
@objc func ayahKeys(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
169
|
+
readPage(tag, resolve, reject) { _, p, _, _ in p.ayahKeys().map { ["surah": $0.0, "ayah": $0.1, "ayahKey": "\($0.0):\($0.1)"] as [String: Any?] } }
|
|
170
|
+
}
|
|
171
|
+
@objc func ayahWordCount(_ tag: NSNumber, s: NSNumber, a: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
172
|
+
readPage(tag, resolve, reject) { _, p, _, _ in let c = p.ayahWordCount(s.intValue, a.intValue); return ["count": c.count, "isComplete": c.isComplete] as [String: Any?] }
|
|
173
|
+
}
|
|
174
|
+
@objc func reciteMap(_ tag: NSNumber, s: NSNumber, a: NSNumber, n: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
175
|
+
readPage(tag, resolve, reject) { _, p, _, _ in p.reciteMap(s.intValue, a.intValue, nSegments: n.intValue) }
|
|
176
|
+
}
|
|
177
|
+
@objc func wordLabel(_ tag: NSNumber, i: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
178
|
+
readPage(tag, resolve, reject) { _, p, _, _ in p.wordLabel(i.intValue) }
|
|
179
|
+
}
|
|
180
|
+
@objc func ayahLabel(_ tag: NSNumber, i: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
181
|
+
readPage(tag, resolve, reject) { _, p, _, _ in p.ayahLabel(i.intValue) }
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
// ── text and search ──
|
|
185
|
+
@objc func text(_ tag: NSNumber, target: Any?, opts: NSDictionary?, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
186
|
+
let o = opt(opts)
|
|
187
|
+
readPage(tag, resolve, reject) { _, p, _, _ in
|
|
188
|
+
p.text(QvpRnMarshal.target(target, p), form: QvpRnMarshal.form(o["form"]), wordSep: QvpRnMarshal.str(o["wordSep"]) ?? " ", lineSep: QvpRnMarshal.str(o["lineSep"]) ?? "\n")
|
|
189
|
+
}
|
|
190
|
+
}
|
|
191
|
+
@objc func search(_ tag: NSNumber, query: String, opts: NSDictionary?, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
192
|
+
let o = opt(opts)
|
|
193
|
+
readPage(tag, resolve, reject) { _, p, _, _ in
|
|
194
|
+
p.search(query, form: QvpRnMarshal.form(o["form"], .search), mode: QvpRnMarshal.searchMode(o["mode"]), normalize: !QvpRnMarshal.isFalse(o["normalize"]),
|
|
195
|
+
looseMatch: !QvpRnMarshal.isFalse(o["looseMatch"]), limit: QvpRnMarshal.num(o["limit"]) ?? 0).map { QvpRnMarshal.match($0) }
|
|
196
|
+
}
|
|
197
|
+
}
|
|
198
|
+
@objc func citation(_ tag: NSNumber, words: NSArray, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
199
|
+
let ws = ints(words)
|
|
200
|
+
readPage(tag, resolve, reject) { _, p, _, _ in p.citation(ws) }
|
|
201
|
+
}
|
|
202
|
+
@objc func arabic(_ op: String, s: String, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
203
|
+
off(resolve, reject) {
|
|
204
|
+
switch op {
|
|
205
|
+
case "strip": return QvpEngine.strip(s)
|
|
206
|
+
case "fold": return QvpEngine.fold(s)
|
|
207
|
+
case "normalize": return QvpEngine.normalize(s)
|
|
208
|
+
case "loose", "looseKey": return QvpEngine.looseKey(s)
|
|
209
|
+
default: return s
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
// ── hit testing and layout (the view does the gestures; these are for scroll-into-view and the like) ──
|
|
215
|
+
/// Exact hit at a point in page units: the outline under the point, else the box of a word or a decoration.
|
|
216
|
+
@objc func hitTestExact(_ tag: NSNumber, x: NSNumber, y: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
217
|
+
withPage(tag, resolve, reject) { _, p in p.hitTestExact(x.floatValue, y.floatValue).map { QvpRnMarshal.hit(p, $0) } }
|
|
218
|
+
}
|
|
219
|
+
/// Gap-aware hit at a point in page units.
|
|
220
|
+
@objc func hitTest(_ tag: NSNumber, x: NSNumber, y: NSNumber, opts: NSDictionary?, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
221
|
+
let o = opt(opts)
|
|
222
|
+
withPage(tag, resolve, reject) { _, p in p.hitTest(x.floatValue, y.floatValue, self.hitOptions(o)).map { QvpRnMarshal.hit(p, $0) } }
|
|
223
|
+
}
|
|
224
|
+
/// Exact hit at a point in view points (the pan and zoom removed here, the layout in the engine).
|
|
225
|
+
@objc func hitTestExactView(_ tag: NSNumber, x: NSNumber, y: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
226
|
+
withPage(tag, resolve, reject) { v, p in
|
|
227
|
+
let l = p.viewToLayout(self.viewOf(v), x.floatValue, y.floatValue)
|
|
228
|
+
return p.hitTestExactView(l.x, l.y).map { QvpRnMarshal.hit(p, $0) }
|
|
229
|
+
}
|
|
230
|
+
}
|
|
231
|
+
@objc func hitTestView(_ tag: NSNumber, x: NSNumber, y: NSNumber, opts: NSDictionary?, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
232
|
+
let o = opt(opts)
|
|
233
|
+
withPage(tag, resolve, reject) { v, p in
|
|
234
|
+
let l = p.viewToLayout(self.viewOf(v), x.floatValue, y.floatValue)
|
|
235
|
+
return p.hitTestView(l.x, l.y, self.hitOptions(o)).map { QvpRnMarshal.hit(p, $0) }
|
|
236
|
+
}
|
|
237
|
+
}
|
|
238
|
+
@objc func wordBoundsView(_ tag: NSNumber, i: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
239
|
+
withPage(tag, resolve, reject) { v, p in
|
|
240
|
+
let s = Float(v.inner.viewScale), ox = Float(v.inner.viewOx), oy = Float(v.inner.viewOy)
|
|
241
|
+
return p.wordBoundsView(i.intValue).map { b in ["x0": ox + b.x0 * s, "y0": oy + b.y0 * s, "x1": ox + b.x1 * s, "y1": oy + b.y1 * s] as [String: Any?] }
|
|
242
|
+
}
|
|
243
|
+
}
|
|
244
|
+
@objc func currentLayout(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
245
|
+
withPage(tag, resolve, reject) { _, p in p.currentLayout.map { QvpRnMarshal.layout($0) } }
|
|
246
|
+
}
|
|
247
|
+
@objc func relayout(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
248
|
+
withPage(tag, resolve, reject) { v, _ in v.inner.relayout(); v.resetView(); return nil }
|
|
249
|
+
}
|
|
250
|
+
@objc func resetView(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
251
|
+
withPage(tag, resolve, reject) { v, _ in v.resetView(); return nil }
|
|
252
|
+
}
|
|
253
|
+
/// The leading that fills this view's viewport. This call and the two after it measure the
|
|
254
|
+
/// printed page, so they take the view's spec before the reader's zoom, as Android does.
|
|
255
|
+
@objc func layoutLineSpacingToFill(_ tag: NSNumber, max: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
256
|
+
withPage(tag, resolve, reject) { v, p in p.layoutLineSpacingToFill(v.inner.baseSpec, max: max.floatValue) }
|
|
257
|
+
}
|
|
258
|
+
@objc func layoutWastedFraction(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
259
|
+
withPage(tag, resolve, reject) { v, p in p.layoutWastedFraction(v.inner.baseSpec) }
|
|
260
|
+
}
|
|
261
|
+
/// The page's height at the printed pitch for the view's spec before the reader's zoom.
|
|
262
|
+
@objc func layoutPrintedHeight(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
263
|
+
withPage(tag, resolve, reject) { v, p in p.layoutPrintedHeight(v.inner.baseSpec) }
|
|
264
|
+
}
|
|
265
|
+
@objc func grid(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
266
|
+
readPage(tag, resolve, reject) { _, p, _, _ in let g = p.grid; return ["lines": g.lines, "lineSpacing": g.lineSpacing] as [String: Any?] }
|
|
267
|
+
}
|
|
268
|
+
@objc func stats(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
269
|
+
ui(resolve, reject) { QvpRnRegistry.get(tag.intValue)?.stats() }
|
|
270
|
+
}
|
|
271
|
+
@objc func invalidate(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
272
|
+
ui(resolve, reject) { QvpRnRegistry.get(tag.intValue)?.inner.setNeedsDisplay(); return nil }
|
|
273
|
+
}
|
|
274
|
+
|
|
275
|
+
// ── selection ──
|
|
276
|
+
@objc func select(_ tag: NSNumber, anchor: NSNumber, focus: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
277
|
+
withPage(tag, resolve, reject) { v, p in p.select(anchor.intValue, focus.intValue); v.inner.setNeedsDisplay(); return QvpRnMarshal.selection(p) }
|
|
278
|
+
}
|
|
279
|
+
@objc func clearSelection(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
280
|
+
withPage(tag, resolve, reject) { v, _ in v.inner.clearSelection(); return nil }
|
|
281
|
+
}
|
|
282
|
+
@objc func selection(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
283
|
+
withPage(tag, resolve, reject) { _, p in QvpRnMarshal.selection(p) }
|
|
284
|
+
}
|
|
285
|
+
@objc func selectionText(_ tag: NSNumber, form: String?, includeCitation: Bool, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
286
|
+
withPage(tag, resolve, reject) { _, p in p.selectionText(QvpRnMarshal.form(form), includeCitation: includeCitation) }
|
|
287
|
+
}
|
|
288
|
+
|
|
289
|
+
// ── memorisation (stepwise calls; the `mask` and `reveal` props hold the declarative part) ──
|
|
290
|
+
@objc func unmaskNext(_ tag: NSNumber, n: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
291
|
+
withPage(tag, resolve, reject) { v, p in let r = p.unmaskNext(n.intValue); v.inner.setNeedsDisplay(); return r }
|
|
292
|
+
}
|
|
293
|
+
@objc func maskBack(_ tag: NSNumber, n: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
294
|
+
withPage(tag, resolve, reject) { v, p in let r = p.maskBack(n.intValue); v.inner.setNeedsDisplay(); return r }
|
|
295
|
+
}
|
|
296
|
+
@objc func unmaskWord(_ tag: NSNumber, i: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
297
|
+
withPage(tag, resolve, reject) { v, p in let r = p.unmaskWord(i.intValue); v.inner.setNeedsDisplay(); return r }
|
|
298
|
+
}
|
|
299
|
+
@objc func maskWord(_ tag: NSNumber, i: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
300
|
+
withPage(tag, resolve, reject) { v, p in let r = p.maskWord(i.intValue); v.inner.setNeedsDisplay(); return r }
|
|
301
|
+
}
|
|
302
|
+
@objc func unmaskAll(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
303
|
+
withPage(tag, resolve, reject) { v, p in p.unmaskAll(); v.inner.setNeedsDisplay(); return nil }
|
|
304
|
+
}
|
|
305
|
+
@objc func maskAll(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
306
|
+
withPage(tag, resolve, reject) { v, p in p.maskAll(); v.inner.setNeedsDisplay(); return nil }
|
|
307
|
+
}
|
|
308
|
+
@objc func maskHidden(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
309
|
+
withPage(tag, resolve, reject) { _, p in p.maskHidden() }
|
|
310
|
+
}
|
|
311
|
+
@objc func maskWords(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
312
|
+
withPage(tag, resolve, reject) { _, p in p.maskWords() }
|
|
313
|
+
}
|
|
314
|
+
@objc func revealStepCount(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
315
|
+
withPage(tag, resolve, reject) { _, p in p.revealStepCount() }
|
|
316
|
+
}
|
|
317
|
+
@objc func revealPosition(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
318
|
+
withPage(tag, resolve, reject) { _, p in p.revealPosition().map(Double.init) }
|
|
319
|
+
}
|
|
320
|
+
@objc func revealStepOf(_ tag: NSNumber, i: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
321
|
+
withPage(tag, resolve, reject) { _, p in Double(p.revealStepOf(i.intValue)) }
|
|
322
|
+
}
|
|
323
|
+
|
|
324
|
+
// ── crop ──
|
|
325
|
+
@objc func cropBounds(_ tag: NSNumber, target: Any?, opts: NSDictionary?, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
326
|
+
let o = opt(opts)
|
|
327
|
+
readPage(tag, resolve, reject) { _, p, _, _ in
|
|
328
|
+
p.cropBounds(QvpRnMarshal.target(target, p), pad: QvpRnMarshal.flt(o["pad"], QvpDefaults.CROP_PAD), keepAyahMarks: !QvpRnMarshal.isFalse(o["keepAyahMarks"]))
|
|
329
|
+
.map { QvpRnMarshal.cropBounds($0) }
|
|
330
|
+
}
|
|
331
|
+
}
|
|
332
|
+
@objc func cropSvg(_ tag: NSNumber, target: Any?, opts: NSDictionary?, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
333
|
+
let o = opt(opts)
|
|
334
|
+
withPage(tag, resolve, reject) { _, p in
|
|
335
|
+
p.cropSvg(QvpRnMarshal.target(target, p), pad: QvpRnMarshal.flt(o["pad"], QvpDefaults.CROP_PAD), keepAyahMarks: !QvpRnMarshal.isFalse(o["keepAyahMarks"]),
|
|
336
|
+
background: QvpRnMarshal.color(o["background"], 0))
|
|
337
|
+
}
|
|
338
|
+
}
|
|
339
|
+
|
|
340
|
+
// ── atlas ──
|
|
341
|
+
@objc func loadAtlas(_ uri: String, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
342
|
+
off(resolve, reject) {
|
|
343
|
+
if let id = self.atlasByUri[uri] { return id }
|
|
344
|
+
let bytes = try QvpRnBytes.read(uri)
|
|
345
|
+
let a: QvpAtlas
|
|
346
|
+
do { a = try QvpAtlas(bytes: bytes) } catch { throw QvpRnError("not a QVP atlas: \(uri) (QvpError.\(error))") }
|
|
347
|
+
let id = self.nextAtlas; self.nextAtlas += 1
|
|
348
|
+
self.atlases[id] = a; self.atlasByUri[uri] = id
|
|
349
|
+
return id
|
|
350
|
+
}
|
|
351
|
+
}
|
|
352
|
+
@objc func freeAtlas(_ id: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
353
|
+
off(resolve, reject) {
|
|
354
|
+
self.atlases.removeValue(forKey: id.intValue)?.close()
|
|
355
|
+
self.atlasByUri = self.atlasByUri.filter { $0.value != id.intValue }
|
|
356
|
+
return nil
|
|
357
|
+
}
|
|
358
|
+
}
|
|
359
|
+
@objc func atlasPageOf(_ id: NSNumber, s: NSNumber, a: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
360
|
+
withAtlas(id, resolve, reject) { $0.pageOf(s.intValue, a.intValue) }
|
|
361
|
+
}
|
|
362
|
+
@objc func atlasPageRange(_ id: NSNumber, page: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
363
|
+
withAtlas(id, resolve, reject) { atlas in
|
|
364
|
+
atlas.pageRange(page.intValue).map { r in
|
|
365
|
+
["first": ["surah": r.first.0, "ayah": r.first.1] as [String: Any?], "last": ["surah": r.last.0, "ayah": r.last.1] as [String: Any?]] as [String: Any?]
|
|
366
|
+
}
|
|
367
|
+
}
|
|
368
|
+
}
|
|
369
|
+
@objc func atlasPageCount(_ id: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
370
|
+
withAtlas(id, resolve, reject) { $0.pageCount() }
|
|
371
|
+
}
|
|
372
|
+
@objc func atlasSurah(_ id: NSNumber, n: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
373
|
+
withAtlas(id, resolve, reject) { $0.surah(n.intValue).map { QvpRnMarshal.atlasSurah($0) } }
|
|
374
|
+
}
|
|
375
|
+
@objc func atlasSurahs(_ id: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
376
|
+
withAtlas(id, resolve, reject) { $0.surahs().map { QvpRnMarshal.atlasSurah($0) } }
|
|
377
|
+
}
|
|
378
|
+
@objc func atlasPageOfSurah(_ id: NSNumber, n: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
379
|
+
withAtlas(id, resolve, reject) { $0.pageOfSurah(n.intValue) }
|
|
380
|
+
}
|
|
381
|
+
@objc func atlasDivision(_ id: NSNumber, division: String, n: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
382
|
+
withAtlas(id, resolve, reject) { $0.division(QvpRnMarshal.division(division), n.intValue).map { QvpRnMarshal.atlasRubuAlHizb($0) } }
|
|
383
|
+
}
|
|
384
|
+
@objc func atlasDivisionOf(_ id: NSNumber, division: String, s: NSNumber, a: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
385
|
+
withAtlas(id, resolve, reject) { $0.divisionOf(QvpRnMarshal.division(division), s.intValue, a.intValue) }
|
|
386
|
+
}
|
|
387
|
+
@objc func atlasJuzOf(_ id: NSNumber, s: NSNumber, a: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
388
|
+
withAtlas(id, resolve, reject) { $0.juzOf(s.intValue, a.intValue) }
|
|
389
|
+
}
|
|
390
|
+
@objc func atlasPagesOfJuz(_ id: NSNumber, n: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
391
|
+
withAtlas(id, resolve, reject) { $0.pagesOfJuz(n.intValue).map { [$0.0, $0.1] } }
|
|
392
|
+
}
|
|
393
|
+
@objc func atlasSearchSurahs(_ id: NSNumber, text: String, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
394
|
+
withAtlas(id, resolve, reject) { $0.searchSurahs(text).map { QvpRnMarshal.atlasSurah($0) } }
|
|
395
|
+
}
|
|
396
|
+
|
|
397
|
+
// ── dress ──
|
|
398
|
+
// An ornament set is held here by id, like an atlas. The C calls behind each method:
|
|
399
|
+
// qvp_ornaments_load, qvp_ornaments_free, qvp_ornament_count, qvp_ornament_info and
|
|
400
|
+
// qvp_ornament_part (one ornament and its parts), qvp_ornament_find, then on the page
|
|
401
|
+
// qvp_dress, qvp_undress and qvp_dress_info. qvp_dress_geometry is the view's: it paints the layer.
|
|
402
|
+
@objc func loadOrnaments(_ uri: String, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
403
|
+
ui(resolve, reject) {
|
|
404
|
+
let bytes = try QvpRnBytes.read(uri)
|
|
405
|
+
let set: QvpOrnaments
|
|
406
|
+
do { set = try QvpOrnaments(bytes: bytes) } catch { throw QvpRnError("not an ornament set: \(uri) (QvpError.\(error))") }
|
|
407
|
+
return QvpOrnamentSets.add(set)
|
|
408
|
+
}
|
|
409
|
+
}
|
|
410
|
+
@objc func freeOrnaments(_ id: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
411
|
+
ui(resolve, reject) { QvpOrnamentSets.free(id.intValue); return nil }
|
|
412
|
+
}
|
|
413
|
+
@objc func ornamentCount(_ id: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
414
|
+
withOrnaments(id, resolve, reject) { $0.count }
|
|
415
|
+
}
|
|
416
|
+
@objc func ornamentInfo(_ id: NSNumber, index: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
417
|
+
withOrnaments(id, resolve, reject) { set in set.list.first { $0.index == index.intValue }.map { QvpRnMarshal.ornament($0) } }
|
|
418
|
+
}
|
|
419
|
+
@objc func ornamentPart(_ id: NSNumber, index: NSNumber, part: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
420
|
+
withOrnaments(id, resolve, reject) { set in
|
|
421
|
+
guard let o = set.list.first(where: { $0.index == index.intValue }), part.intValue >= 0, part.intValue < o.parts.count else { return nil }
|
|
422
|
+
return QvpRnMarshal.ornamentPart(o.parts[part.intValue])
|
|
423
|
+
}
|
|
424
|
+
}
|
|
425
|
+
@objc func ornamentList(_ id: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
426
|
+
withOrnaments(id, resolve, reject) { $0.list.map { QvpRnMarshal.ornament($0) } }
|
|
427
|
+
}
|
|
428
|
+
@objc func ornamentFind(_ id: NSNumber, kind: String, style: String, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
429
|
+
withOrnaments(id, resolve, reject) { set in QvpRnMarshal.ornamentKind(kind).flatMap { set.find($0, style)?.index } ?? -1 }
|
|
430
|
+
}
|
|
431
|
+
/// Dress the page behind a view. The `dress` prop does the same declaratively; this call lasts until the next page.
|
|
432
|
+
@objc func dress(_ tag: NSNumber, id: NSNumber, spec: NSDictionary?, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
433
|
+
let s = QvpRnMarshal.dressSpec(opt(spec))
|
|
434
|
+
withPage(tag, resolve, reject) { v, p in
|
|
435
|
+
guard let set = QvpOrnamentSets.get(id.intValue) else { throw QvpRnError("no ornament set \(id)") }
|
|
436
|
+
return v.dressNow(p, set, s).map { QvpRnMarshal.dressInfo($0) }
|
|
437
|
+
}
|
|
438
|
+
}
|
|
439
|
+
@objc func undress(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
440
|
+
withPage(tag, resolve, reject) { v, p in v.undressNow(p); return nil }
|
|
441
|
+
}
|
|
442
|
+
/// The engine's clamp of a view over the content plus the dress overflow. Offsets and viewport are in points, like the other view methods.
|
|
443
|
+
@objc func dressClamp(_ tag: NSNumber, scale: NSNumber, offsetX: NSNumber, offsetY: NSNumber, viewportW: NSNumber, viewportH: NSNumber,
|
|
444
|
+
resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
445
|
+
withPage(tag, resolve, reject) { _, p in
|
|
446
|
+
let c = p.dressClamp(QvpView(scale: scale.floatValue, offsetX: offsetX.floatValue, offsetY: offsetY.floatValue), viewportW: viewportW.floatValue, viewportH: viewportH.floatValue)
|
|
447
|
+
return ["scale": c.scale, "offsetX": c.offsetX, "offsetY": c.offsetY] as [String: Any?]
|
|
448
|
+
}
|
|
449
|
+
}
|
|
450
|
+
/// The engine's view and dressed box size for a host that scrolls the page. The viewport, offsets and size are in points.
|
|
451
|
+
@objc func dressView(_ tag: NSNumber, scale: NSNumber, viewportW: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
452
|
+
withPage(tag, resolve, reject) { _, p in
|
|
453
|
+
let r = p.dressView(scale.floatValue, viewportW: viewportW.floatValue)
|
|
454
|
+
return ["view": ["scale": r.view.scale, "offsetX": r.view.offsetX, "offsetY": r.view.offsetY] as [String: Any?], "width": r.width, "height": r.height] as [String: Any?]
|
|
455
|
+
}
|
|
456
|
+
}
|
|
457
|
+
@objc func dressInfo(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
458
|
+
withPage(tag, resolve, reject) { _, p in p.dressInfo().map { QvpRnMarshal.dressInfo($0) } }
|
|
459
|
+
}
|
|
460
|
+
@objc func dressRevision(_ tag: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
461
|
+
withPage(tag, resolve, reject) { _, p in p.dressRevision() }
|
|
462
|
+
}
|
|
463
|
+
|
|
464
|
+
// ── names ──
|
|
465
|
+
@objc func markName(_ m: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
466
|
+
off(resolve, reject) { QvpEngine.markName(m.intValue) }
|
|
467
|
+
}
|
|
468
|
+
@objc func markFromName(_ s: String, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
469
|
+
off(resolve, reject) { QvpEngine.markFromName(s) }
|
|
470
|
+
}
|
|
471
|
+
@objc func markCategory(_ m: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
472
|
+
off(resolve, reject) { QvpEngine.markCategory(m.intValue) }
|
|
473
|
+
}
|
|
474
|
+
@objc func engineName(_ resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
|
|
475
|
+
off(resolve, reject) { QvpEngine.engineName() }
|
|
476
|
+
}
|
|
477
|
+
|
|
478
|
+
/// Every name table, read from the engine; the JavaScript side resolves names with these.
|
|
479
|
+
@objc func constantsToExport() -> [AnyHashable: Any]! {
|
|
480
|
+
["version": QvpEngine.version(), "formatVersion": QvpEngine.formatVersion(),
|
|
481
|
+
"marks": QvpEngine.names(QvpEngine.Names.mark), "kinds": QvpEngine.names(QvpEngine.Names.kind),
|
|
482
|
+
"families": QvpEngine.names(QvpEngine.Names.family), "categories": QvpEngine.names(QvpEngine.Names.category),
|
|
483
|
+
"decorations": QvpEngine.names(QvpEngine.Names.decoration), "divisions": QvpEngine.names(QvpEngine.Names.division),
|
|
484
|
+
"places": QvpEngine.names(QvpEngine.Names.place),
|
|
485
|
+
// the whole defaults table by camelCase name, as the decimals the header states
|
|
486
|
+
"defaults": QvpDefaults.decimal]
|
|
487
|
+
}
|
|
488
|
+
|
|
489
|
+
@objc func invalidate() {
|
|
490
|
+
// The atlases belong to the query queue: free them there, after the queries already queued.
|
|
491
|
+
queries.async { self.atlases.values.forEach { $0.close() }; self.atlases = [:]; self.atlasByUri = [:] }
|
|
492
|
+
DispatchQueue.main.async { QvpOrnamentSets.clear() }
|
|
493
|
+
}
|
|
494
|
+
}
|
|
495
|
+
|
|
496
|
+
/// Ornament sets by id, shared by the module and the views: the `dress` prop names its set by
|
|
497
|
+
/// this id. A dressed page keeps what it needs, so freeing a set never breaks a page that wears
|
|
498
|
+
/// it. Touched only on the main thread.
|
|
499
|
+
enum QvpOrnamentSets {
|
|
500
|
+
private static var sets: [Int: QvpOrnaments] = [:]
|
|
501
|
+
private static var next = 1
|
|
502
|
+
static func add(_ set: QvpOrnaments) -> Int { let id = next; next += 1; sets[id] = set; return id }
|
|
503
|
+
static func get(_ id: Int?) -> QvpOrnaments? { id.flatMap { sets[$0] } }
|
|
504
|
+
static func free(_ id: Int) { sets.removeValue(forKey: id)?.close() }
|
|
505
|
+
static func clear() { sets.values.forEach { $0.close() }; sets = [:] }
|
|
506
|
+
}
|
|
507
|
+
|
|
508
|
+
extension QvpModule: RCTInvalidating {}
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
// @quran.ws/qvp-react-native, iOS. The bytes a URI names, and the word records of a page.
|
|
2
|
+
import Foundation
|
|
3
|
+
|
|
4
|
+
/// The bytes a prop-given URI names. The schemes are Android's: on iOS an asset is a file in the
|
|
5
|
+
/// app bundle, so `asset://pages/001.qvp` is `pages/001.qvp` under the bundle's resources.
|
|
6
|
+
enum QvpRnBytes {
|
|
7
|
+
static func read(_ uri: String) throws -> Data {
|
|
8
|
+
let u = uri.trimmingCharacters(in: .whitespacesAndNewlines)
|
|
9
|
+
if u.hasPrefix("base64:") {
|
|
10
|
+
guard let d = Data(base64Encoded: String(u.dropFirst(7)), options: .ignoreUnknownCharacters) else { throw QvpRnError("not base64: \(u.prefix(32))") }
|
|
11
|
+
return d
|
|
12
|
+
}
|
|
13
|
+
return try Data(contentsOf: URL(fileURLWithPath: path(u)))
|
|
14
|
+
}
|
|
15
|
+
private static func path(_ u: String) -> String {
|
|
16
|
+
if u.hasPrefix("file://") { return URL(string: u)?.path ?? String(u.dropFirst(7)) }
|
|
17
|
+
if u.hasPrefix("/") { return u }
|
|
18
|
+
let asset = u.hasPrefix("asset://") ? String(u.dropFirst(8)) : u.hasPrefix("asset:") ? String(u.dropFirst(6)) : u
|
|
19
|
+
return (Bundle.main.resourcePath ?? "") + "/" + asset
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
/// An error with a message JavaScript reads.
|
|
24
|
+
struct QvpRnError: LocalizedError {
|
|
25
|
+
let message: String
|
|
26
|
+
init(_ message: String) { self.message = message }
|
|
27
|
+
var errorDescription: String? { message }
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/// The bridge record of each word of one page, built the first time the word is asked for and
|
|
31
|
+
/// kept. A record holds the word's text forms, its label and the names of its paths. The words
|
|
32
|
+
/// sidecar is attached once per page, so a record does not change until the next attach, and
|
|
33
|
+
/// the view drops this table then. The module's query queue and the main thread both call it.
|
|
34
|
+
final class QvpRnWords {
|
|
35
|
+
let page: QvpPage
|
|
36
|
+
private let lock = NSLock()
|
|
37
|
+
private var cachedForms: [Form]?
|
|
38
|
+
private var records: [[String: Any?]?]
|
|
39
|
+
|
|
40
|
+
init(_ page: QvpPage) { self.page = page; records = Array(repeating: nil, count: page.nWords) }
|
|
41
|
+
|
|
42
|
+
/// The forms this page has. Each one is a scan of every word in the engine, so read them once.
|
|
43
|
+
var forms: [Form] {
|
|
44
|
+
lock.lock(); defer { lock.unlock() }
|
|
45
|
+
return formsLocked()
|
|
46
|
+
}
|
|
47
|
+
private func formsLocked() -> [Form] {
|
|
48
|
+
if let f = cachedForms { return f }
|
|
49
|
+
let f = QvpRnMarshal.forms(page)
|
|
50
|
+
cachedForms = f
|
|
51
|
+
return f
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/// The record of word `index`, or nil when the page has no such word.
|
|
55
|
+
func word(_ index: Int) -> [String: Any?]? {
|
|
56
|
+
guard index >= 0, index < page.words.count else { return nil }
|
|
57
|
+
lock.lock(); defer { lock.unlock() }
|
|
58
|
+
if let r = records[index] { return r }
|
|
59
|
+
let r = QvpRnMarshal.word(page, page.words[index], formsLocked())
|
|
60
|
+
records[index] = r
|
|
61
|
+
return r
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
/// Every word's record, in page order.
|
|
65
|
+
func all() -> [[String: Any?]] { (0..<page.nWords).compactMap { word($0) } }
|
|
66
|
+
}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
// Generated by scripts/gen-rn-enums.py from crates/qvp-ffi/include/qvp.h. Do not edit.
|
|
2
|
+
|
|
3
|
+
/// The QVP_TARGET_* and QVP_SELECTOR_* codes, and each code by its JavaScript name.
|
|
4
|
+
enum QvpRnCodes {
|
|
5
|
+
static let TARGET_PAGE = 0
|
|
6
|
+
static let TARGET_WORD = 1
|
|
7
|
+
static let TARGET_WORDS = 2
|
|
8
|
+
static let TARGET_AYAH = 3
|
|
9
|
+
static let TARGET_AYAH_RANGE = 4
|
|
10
|
+
static let TARGET_LINE = 5
|
|
11
|
+
static let TARGET_SURAH = 6
|
|
12
|
+
static let TARGET_RANGE = 7
|
|
13
|
+
/// QVP_TARGET_*: the kind of a target, by name.
|
|
14
|
+
static let TARGETS: [String: Int] = ["page": TARGET_PAGE, "word": TARGET_WORD, "words": TARGET_WORDS, "ayah": TARGET_AYAH, "ayahRange": TARGET_AYAH_RANGE, "line": TARGET_LINE, "surah": TARGET_SURAH, "range": TARGET_RANGE]
|
|
15
|
+
static let SELECTOR_PAGE = 0
|
|
16
|
+
static let SELECTOR_PATH = 1
|
|
17
|
+
static let SELECTOR_WORD_PATH = 2
|
|
18
|
+
static let SELECTOR_WORD_MARK = 3
|
|
19
|
+
static let SELECTOR_WORD_MARK_NAMED = 4
|
|
20
|
+
static let SELECTOR_WORD_BODY = 5
|
|
21
|
+
static let SELECTOR_WORD_MARKS = 6
|
|
22
|
+
static let SELECTOR_WORD = 7
|
|
23
|
+
static let SELECTOR_AYAH = 8
|
|
24
|
+
static let SELECTOR_LINE = 9
|
|
25
|
+
static let SELECTOR_MARK = 10
|
|
26
|
+
static let SELECTOR_CATEGORY = 11
|
|
27
|
+
static let SELECTOR_FAMILY = 12
|
|
28
|
+
static let SELECTOR_KIND = 13
|
|
29
|
+
static let SELECTOR_DECORATION = 14
|
|
30
|
+
static let SELECTOR_DECORATION_INDEX = 15
|
|
31
|
+
/// QVP_SELECTOR_*: the kind of a selector, by name.
|
|
32
|
+
static let SELECTORS: [String: Int] = ["page": SELECTOR_PAGE, "path": SELECTOR_PATH, "wordPath": SELECTOR_WORD_PATH, "wordMark": SELECTOR_WORD_MARK, "wordMarkNamed": SELECTOR_WORD_MARK_NAMED, "wordBody": SELECTOR_WORD_BODY, "wordMarks": SELECTOR_WORD_MARKS, "word": SELECTOR_WORD, "ayah": SELECTOR_AYAH, "line": SELECTOR_LINE, "mark": SELECTOR_MARK, "category": SELECTOR_CATEGORY, "family": SELECTOR_FAMILY, "kind": SELECTOR_KIND, "decoration": SELECTOR_DECORATION, "decorationIndex": SELECTOR_DECORATION_INDEX]
|
|
33
|
+
}
|