react-native-live-widgets 0.0.0-stage → 1.1.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.
Files changed (65) hide show
  1. package/CHANGELOG.md +21 -0
  2. package/LICENSE +21 -0
  3. package/README.md +367 -2
  4. package/android/build.gradle +49 -0
  5. package/android/src/main/AndroidManifest.xml +38 -0
  6. package/android/src/main/java/com/reactnativeliveactivity/bridge/LiveActivityModule.kt +441 -0
  7. package/android/src/main/java/com/reactnativeliveactivity/bridge/LiveActivityPackage.kt +17 -0
  8. package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityHeadlessTaskService.kt +24 -0
  9. package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityNotifier.kt +410 -0
  10. package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityReceiver.kt +67 -0
  11. package/android/src/main/java/com/reactnativeliveactivity/renderer/DynamicNodeRegistry.kt +64 -0
  12. package/android/src/main/java/com/reactnativeliveactivity/renderer/DynamicWidgetCanvasRenderer.kt +1223 -0
  13. package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetImageCache.kt +120 -0
  14. package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetStateStore.kt +281 -0
  15. package/android/src/main/java/com/reactnativeliveactivity/widgets/DynamicHomeScreenWidgetProvider.kt +229 -0
  16. package/android/src/main/res/layout/rn_live_widget_host.xml +113 -0
  17. package/android/src/main/res/xml/rn_live_widget_info.xml +14 -0
  18. package/app.plugin.js +114 -0
  19. package/assets/cross_platform_parity.png +0 -0
  20. package/assets/dashboard_features.png +0 -0
  21. package/assets/donate_qr.png +0 -0
  22. package/assets/dynamic_island_expanded.png +0 -0
  23. package/assets/home_widget_interactive.png +0 -0
  24. package/assets/lock_screen_live_activity.png +0 -0
  25. package/cli/setup.js +491 -0
  26. package/docs/EXPO-GUIDE-EN.md +405 -0
  27. package/docs/EXPO-GUIDE-VI.md +427 -0
  28. package/docs/GUIDE-EN.md +847 -0
  29. package/docs/GUIDE-VI.md +845 -0
  30. package/docs/widgets.md +52 -0
  31. package/ios/Bridge/LiveActivityModule.m +105 -0
  32. package/ios/Bridge/LiveActivityModule.swift +957 -0
  33. package/ios/Intents/DynamicWidgetActionIntent.swift +38 -0
  34. package/ios/Models/DynamicActivityAttributes.swift +22 -0
  35. package/ios/Models/DynamicLayoutModels.swift +243 -0
  36. package/ios/Renderer/ColorHexExtension.swift +49 -0
  37. package/ios/Renderer/DynamicNodeRegistry.swift +54 -0
  38. package/ios/Renderer/DynamicNodeView.swift +1060 -0
  39. package/ios/Storage/DynamicWidgetImageCache.swift +137 -0
  40. package/ios/Storage/DynamicWidgetStateStore.swift +162 -0
  41. package/ios/Widgets/DynamicHomeScreenWidget.swift +435 -0
  42. package/ios/Widgets/DynamicLiveActivityWidget.swift +79 -0
  43. package/lib/builder.d.ts +60 -0
  44. package/lib/builder.d.ts.map +1 -0
  45. package/lib/builder.js +292 -0
  46. package/lib/builder.js.map +1 -0
  47. package/lib/dispatcher.d.ts +16 -0
  48. package/lib/dispatcher.d.ts.map +1 -0
  49. package/lib/dispatcher.js +18 -0
  50. package/lib/dispatcher.js.map +1 -0
  51. package/lib/index.d.ts +199 -0
  52. package/lib/index.d.ts.map +1 -0
  53. package/lib/index.js +621 -0
  54. package/lib/index.js.map +1 -0
  55. package/lib/types.d.ts +489 -0
  56. package/lib/types.d.ts.map +1 -0
  57. package/lib/types.js +9 -0
  58. package/lib/types.js.map +1 -0
  59. package/package.json +85 -4
  60. package/react-native-live-widgets.podspec +38 -0
  61. package/src/builder.ts +409 -0
  62. package/src/dispatcher.ts +25 -0
  63. package/src/index.ts +689 -0
  64. package/src/react-native-env.d.ts +29 -0
  65. package/src/types.ts +595 -0
@@ -0,0 +1,137 @@
1
+ import Foundation
2
+ import UIKit
3
+
4
+ // MARK: - Image Cache & Prefetcher for WidgetKit & ActivityKit
5
+
6
+ public enum DynamicWidgetImageCache {
7
+ private static let memCache = NSCache<NSString, UIImage>()
8
+
9
+ public static func cacheKey(for urlStr: String) -> String {
10
+ var hash: UInt64 = 5381
11
+ for byte in urlStr.utf8 {
12
+ hash = ((hash << 5) &+ hash) &+ UInt64(byte)
13
+ }
14
+ return String(format: "img_%016llx", hash)
15
+ }
16
+
17
+ public static func cachedImage(for urlStr: String) -> UIImage? {
18
+ let key = cacheKey(for: urlStr)
19
+ if let mem = memCache.object(forKey: key as NSString) {
20
+ return mem
21
+ }
22
+
23
+ if let fileURL = DynamicWidgetProvider.sharedFileURL(key: key, appGroup: ""),
24
+ let data = try? Data(contentsOf: fileURL),
25
+ let img = UIImage(data: data) {
26
+ memCache.setObject(img, forKey: key as NSString)
27
+ return img
28
+ }
29
+
30
+ #if targetEnvironment(simulator)
31
+ let simPath = "/tmp/rn_live_widgets_\(key).dat"
32
+ if let data = try? Data(contentsOf: URL(fileURLWithPath: simPath)),
33
+ let img = UIImage(data: data) {
34
+ memCache.setObject(img, forKey: key as NSString)
35
+ return img
36
+ }
37
+ #endif
38
+
39
+ return nil
40
+ }
41
+
42
+ public static func saveImageData(_ rawData: Data, for urlStr: String) {
43
+ guard UIImage(data: rawData) != nil else { return }
44
+ let key = cacheKey(for: urlStr)
45
+ let optimizedData = downscaleImageData(rawData, maxDimension: 360) ?? rawData
46
+
47
+ if let img = UIImage(data: optimizedData) {
48
+ memCache.setObject(img, forKey: key as NSString)
49
+ }
50
+
51
+ if let fileURL = DynamicWidgetProvider.sharedFileURL(key: key, appGroup: "") {
52
+ try? optimizedData.write(to: fileURL, options: .atomic)
53
+ }
54
+
55
+ #if targetEnvironment(simulator)
56
+ let simPath = "/tmp/rn_live_widgets_\(key).dat"
57
+ try? optimizedData.write(to: URL(fileURLWithPath: simPath), options: .atomic)
58
+ #endif
59
+ }
60
+
61
+ public static func hasUncachedUrls(in jsonString: String) -> Bool {
62
+ guard jsonString.contains("http") else { return false }
63
+ let pattern = #""url"\s*:\s*"(https?://[^"]+)""#
64
+ guard let regex = try? NSRegularExpression(pattern: pattern) else { return false }
65
+ let nsRange = NSRange(jsonString.startIndex..<jsonString.endIndex, in: jsonString)
66
+ let matches = regex.matches(in: jsonString, range: nsRange)
67
+ for match in matches {
68
+ if match.numberOfRanges > 1,
69
+ let r = Range(match.range(at: 1), in: jsonString) {
70
+ let urlStr = String(jsonString[r])
71
+ if cachedImage(for: urlStr) == nil {
72
+ return true
73
+ }
74
+ }
75
+ }
76
+ return false
77
+ }
78
+
79
+ /// - Returns: true nếu có ít nhất 1 ảnh mới được tải về (chưa có trong cache trước đó).
80
+ @discardableResult
81
+ public static func prefetchUrls(in jsonString: String) async -> Bool {
82
+ guard jsonString.contains("http") else { return false }
83
+ let pattern = #""url"\s*:\s*"(https?://[^"]+)""#
84
+ guard let regex = try? NSRegularExpression(pattern: pattern) else { return false }
85
+ let nsRange = NSRange(jsonString.startIndex..<jsonString.endIndex, in: jsonString)
86
+ let matches = regex.matches(in: jsonString, range: nsRange)
87
+
88
+ var urls = Set<String>()
89
+ for match in matches {
90
+ if match.numberOfRanges > 1,
91
+ let r = Range(match.range(at: 1), in: jsonString) {
92
+ urls.insert(String(jsonString[r]))
93
+ }
94
+ }
95
+
96
+ let missing = urls.filter { cachedImage(for: $0) == nil }
97
+ guard !missing.isEmpty else { return false }
98
+
99
+ return await withTaskGroup(of: Bool.self) { group in
100
+ for urlStr in missing {
101
+ guard let url = URL(string: urlStr) else { continue }
102
+ group.addTask {
103
+ var req = URLRequest(url: url)
104
+ req.timeoutInterval = 2.0
105
+ if let (data, _) = try? await URLSession.shared.data(for: req), !data.isEmpty {
106
+ saveImageData(data, for: urlStr)
107
+ return true
108
+ }
109
+ return false
110
+ }
111
+ }
112
+ var any = false
113
+ for await ok in group where ok { any = true }
114
+ return any
115
+ }
116
+ }
117
+
118
+ private static func downscaleImageData(_ data: Data, maxDimension: CGFloat) -> Data? {
119
+ guard let image = UIImage(data: data) else { return nil }
120
+ let size = image.size
121
+ guard size.width > 0, size.height > 0 else { return data }
122
+ let maxSide = max(size.width, size.height)
123
+ if maxSide <= maxDimension {
124
+ return image.pngData() ?? image.jpegData(compressionQuality: 0.85) ?? data
125
+ }
126
+ let scale = maxDimension / maxSide
127
+ let newSize = CGSize(width: max(1, round(size.width * scale)), height: max(1, round(size.height * scale)))
128
+ let format = UIGraphicsImageRendererFormat()
129
+ format.scale = 1.0
130
+ let renderer = UIGraphicsImageRenderer(size: newSize, format: format)
131
+ let resized = renderer.image { _ in
132
+ image.draw(in: CGRect(origin: .zero, size: newSize))
133
+ }
134
+ return resized.jpegData(compressionQuality: 0.85) ?? data
135
+ }
136
+ }
137
+
@@ -0,0 +1,162 @@
1
+ import Foundation
2
+
3
+ // MARK: - Interactive Widget State Store & Background Remote Sync
4
+
5
+ public enum DynamicWidgetStateStore {
6
+ private static let stateKey = "interactive_state"
7
+ private static var memoryCache: InteractiveWidgetState?
8
+
9
+ public static func loadState() -> InteractiveWidgetState {
10
+ if let fileURL = DynamicWidgetProvider.sharedFileURL(key: stateKey, appGroup: ""),
11
+ let data = try? Data(contentsOf: fileURL),
12
+ let state = try? JSONDecoder().decode(InteractiveWidgetState.self, from: data) {
13
+ return state
14
+ }
15
+
16
+ #if targetEnvironment(simulator)
17
+ let simPath = "/tmp/rn_live_widgets_\(stateKey).json"
18
+ if let data = try? Data(contentsOf: URL(fileURLWithPath: simPath)),
19
+ let state = try? JSONDecoder().decode(InteractiveWidgetState.self, from: data) {
20
+ return state
21
+ }
22
+ #endif
23
+
24
+ let resolvedGroup = DynamicWidgetProvider.resolveAppGroup("")
25
+ if !resolvedGroup.isEmpty,
26
+ let defaults = UserDefaults(suiteName: resolvedGroup),
27
+ let jsonStr = defaults.string(forKey: stateKey),
28
+ let data = jsonStr.data(using: .utf8),
29
+ let state = try? JSONDecoder().decode(InteractiveWidgetState.self, from: data) {
30
+ return state
31
+ }
32
+
33
+ return memoryCache ?? InteractiveWidgetState()
34
+ }
35
+
36
+ public static func saveState(_ state: InteractiveWidgetState) {
37
+ memoryCache = state
38
+ guard let data = try? JSONEncoder().encode(state),
39
+ let jsonStr = String(data: data, encoding: .utf8) else {
40
+ return
41
+ }
42
+
43
+ if let fileURL = DynamicWidgetProvider.sharedFileURL(key: stateKey, appGroup: "") {
44
+ try? jsonStr.write(to: fileURL, atomically: true, encoding: .utf8)
45
+ }
46
+
47
+ #if targetEnvironment(simulator)
48
+ let simPath = "/tmp/rn_live_widgets_\(stateKey).json"
49
+ try? jsonStr.write(toFile: simPath, atomically: true, encoding: .utf8)
50
+ #endif
51
+
52
+ let resolvedGroup = DynamicWidgetProvider.resolveAppGroup("")
53
+ if !resolvedGroup.isEmpty, let defaults = UserDefaults(suiteName: resolvedGroup) {
54
+ defaults.set(jsonStr, forKey: stateKey)
55
+ defaults.synchronize()
56
+ }
57
+ }
58
+
59
+ public static func handleAction(_ actionId: String) {
60
+ var state = loadState()
61
+ state.lastActionId = actionId
62
+ state.updatedAt = Date().timeIntervalSince1970
63
+
64
+ if actionId.hasPrefix("page:") {
65
+ let target = String(actionId.dropFirst(5))
66
+ let order = state.pageOrder ?? []
67
+ if target == "next", !order.isEmpty {
68
+ let current = state.activePage ?? order[0]
69
+ if let idx = order.firstIndex(of: current) {
70
+ state.activePage = order[(idx + 1) % order.count]
71
+ } else {
72
+ state.activePage = order[0]
73
+ }
74
+ } else if target == "prev", !order.isEmpty {
75
+ let current = state.activePage ?? order[0]
76
+ if let idx = order.firstIndex(of: current) {
77
+ state.activePage = order[(idx - 1 + order.count) % order.count]
78
+ } else {
79
+ state.activePage = order[0]
80
+ }
81
+ } else {
82
+ state.activePage = target
83
+ }
84
+ } else if actionId.hasPrefix("toggle:") {
85
+ let key = String(actionId.dropFirst(7))
86
+ let current = state.toggledItems[key] ?? false
87
+ state.toggledItems[key] = !current
88
+ }
89
+
90
+ saveState(state)
91
+ }
92
+
93
+ public static func isToggled(_ key: String) -> Bool {
94
+ return loadState().toggledItems[key] ?? false
95
+ }
96
+
97
+ /// Chạy ngầm độc lập bên trong Widget Extension (kể cả khi Main App đã bị kill hoàn toàn)
98
+ public static func performRemoteSync(widgetKey: String = "main") async {
99
+ let configKey = "widget_remote_config_\(widgetKey)"
100
+ guard let configJson = DynamicWidgetProvider.readSharedString(forKey: configKey, appGroup: ""),
101
+ let configData = configJson.data(using: .utf8),
102
+ let config = try? JSONDecoder().decode(WidgetRemoteConfigDTO.self, from: configData) else {
103
+ stampSyncTimeOnly()
104
+ return
105
+ }
106
+
107
+ let randomId = Int.random(in: 1...20)
108
+ let resolvedUrlStr = config.url.replacingOccurrences(of: "{{_randomId}}", with: "\(randomId)")
109
+ guard let url = URL(string: resolvedUrlStr) else {
110
+ stampSyncTimeOnly()
111
+ return
112
+ }
113
+
114
+ var request = URLRequest(url: url)
115
+ request.httpMethod = config.method ?? "GET"
116
+ request.timeoutInterval = 3.0
117
+ if let headers = config.headers {
118
+ for (k, v) in headers {
119
+ request.setValue(v, forHTTPHeaderField: k)
120
+ }
121
+ }
122
+
123
+ do {
124
+ let (data, _) = try await URLSession.shared.data(for: request)
125
+ var state = loadState()
126
+ let formatter = DateFormatter()
127
+ formatter.dateFormat = "HH:mm:ss"
128
+ state.lastSyncTime = formatter.string(from: Date())
129
+ state.updatedAt = Date().timeIntervalSince1970
130
+
131
+ if let jsonObj = try? JSONSerialization.jsonObject(with: data) as? [String: Any] {
132
+ if jsonObj["small"] != nil || jsonObj["medium"] != nil || jsonObj["large"] != nil || jsonObj["pages"] != nil,
133
+ let rawStr = String(data: data, encoding: .utf8) {
134
+ DynamicWidgetProvider.writeSharedString(rawStr, forKey: "widget_layout_\(widgetKey)", appGroup: "")
135
+ }
136
+
137
+ var vars = state.remoteVariables ?? [:]
138
+ for (k, v) in jsonObj {
139
+ if let s = v as? String {
140
+ vars[k] = s
141
+ } else if let n = v as? NSNumber {
142
+ vars[k] = n.stringValue
143
+ }
144
+ }
145
+ state.remoteVariables = vars
146
+ }
147
+ saveState(state)
148
+ } catch {
149
+ stampSyncTimeOnly()
150
+ }
151
+ }
152
+
153
+ private static func stampSyncTimeOnly() {
154
+ var state = loadState()
155
+ let formatter = DateFormatter()
156
+ formatter.dateFormat = "HH:mm:ss"
157
+ state.lastSyncTime = formatter.string(from: Date())
158
+ state.updatedAt = Date().timeIntervalSince1970
159
+ saveState(state)
160
+ }
161
+ }
162
+