react-native-live-widgets 1.2.1 → 1.2.3

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 (79) hide show
  1. package/CHANGELOG.md +37 -0
  2. package/README.md +89 -49
  3. package/android/src/main/AndroidManifest.xml +12 -0
  4. package/android/src/main/assets/fonts/MaterialIcons-Regular.ttf +0 -0
  5. package/android/src/main/java/com/reactnativeliveactivity/bridge/LiveActivityModule.kt +61 -1
  6. package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityNotifier.kt +153 -17
  7. package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityReceiver.kt +1 -1
  8. package/android/src/main/java/com/reactnativeliveactivity/renderer/DynamicWidgetCanvasRenderer.kt +86 -13
  9. package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetImageCache.kt +53 -0
  10. package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetStateStore.kt +647 -104
  11. package/android/src/main/java/com/reactnativeliveactivity/widgets/DynamicHomeScreenWidgetProvider.kt +3 -1
  12. package/android/src/main/java/com/reactnativeliveactivity/widgets/DynamicQuickSettingsTileService.kt +120 -0
  13. package/app.plugin.js +36 -0
  14. package/assets/MaterialIcons.json +2236 -0
  15. package/cli/codegen.js +889 -0
  16. package/cli/setup.js +323 -63
  17. package/docs/EXPO-GUIDE-EN.md +21 -3
  18. package/docs/EXPO-GUIDE-VI.md +21 -3
  19. package/docs/GUIDE-EN.md +203 -21
  20. package/docs/GUIDE-VI.md +207 -22
  21. package/docs/index.html +1461 -226
  22. package/docs/llms-full.txt +15 -0
  23. package/docs/llms.txt +16 -7
  24. package/ios/Bridge/LiveActivityModule.swift +333 -44
  25. package/ios/Intents/DynamicWidgetActionIntent.swift +57 -2
  26. package/ios/Models/DynamicLayoutModels.swift +114 -4
  27. package/ios/Renderer/DynamicNodeView.swift +15 -6
  28. package/ios/Storage/DynamicWidgetStateStore.swift +649 -38
  29. package/ios/Widgets/DynamicControlWidget.swift +63 -0
  30. package/ios/Widgets/DynamicHomeScreenWidget.swift +99 -26
  31. package/ios/Widgets/DynamicLiveActivityWidget.swift +25 -4
  32. package/lib/builder.d.ts +50 -7
  33. package/lib/builder.d.ts.map +1 -1
  34. package/lib/builder.js +326 -18
  35. package/lib/builder.js.map +1 -1
  36. package/lib/hooks.d.ts +13 -9
  37. package/lib/hooks.d.ts.map +1 -1
  38. package/lib/hooks.js +70 -12
  39. package/lib/hooks.js.map +1 -1
  40. package/lib/index.d.ts +80 -7
  41. package/lib/index.d.ts.map +1 -1
  42. package/lib/index.js +303 -59
  43. package/lib/index.js.map +1 -1
  44. package/lib/ir.d.ts.map +1 -1
  45. package/lib/ir.js +9 -2
  46. package/lib/ir.js.map +1 -1
  47. package/lib/jsx.d.ts +11 -7
  48. package/lib/jsx.d.ts.map +1 -1
  49. package/lib/jsx.js +50 -13
  50. package/lib/jsx.js.map +1 -1
  51. package/lib/material-icons.generated.d.ts +8 -0
  52. package/lib/material-icons.generated.d.ts.map +1 -0
  53. package/lib/material-icons.generated.js +9 -0
  54. package/lib/material-icons.generated.js.map +1 -0
  55. package/lib/preview.d.ts +11 -4
  56. package/lib/preview.d.ts.map +1 -1
  57. package/lib/preview.js +150 -82
  58. package/lib/preview.js.map +1 -1
  59. package/lib/sf-symbols.generated.d.ts +8 -0
  60. package/lib/sf-symbols.generated.d.ts.map +1 -0
  61. package/lib/sf-symbols.generated.js +9 -0
  62. package/lib/sf-symbols.generated.js.map +1 -0
  63. package/lib/types.d.ts +302 -18
  64. package/lib/types.d.ts.map +1 -1
  65. package/package.json +6 -2
  66. package/scripts/build.js +98 -0
  67. package/scripts/generate-material-icons.js +93 -0
  68. package/scripts/generate-sf-symbols.js +95 -0
  69. package/scripts/release.js +115 -0
  70. package/scripts/test-ir-semantic.js +314 -0
  71. package/src/builder.ts +382 -24
  72. package/src/hooks.ts +88 -12
  73. package/src/index.ts +319 -56
  74. package/src/ir.ts +8 -2
  75. package/src/jsx.tsx +69 -21
  76. package/src/material-icons.generated.ts +3844 -0
  77. package/src/preview.tsx +235 -81
  78. package/src/sf-symbols.generated.ts +9533 -0
  79. package/src/types.ts +348 -18
@@ -1,3 +1,4 @@
1
+ import ActivityKit
1
2
  import AppIntents
2
3
  import WidgetKit
3
4
 
@@ -22,9 +23,26 @@ public struct DynamicWidgetActionIntent: AppIntent {
22
23
  public func perform() async throws -> some IntentResult {
23
24
  if actionId == "refresh" || actionId.hasPrefix("refresh:") {
24
25
  let key = actionId.hasPrefix("refresh:") ? String(actionId.dropFirst(8)) : "main"
25
- await DynamicWidgetStateStore.performRemoteSync(widgetKey: key)
26
+ await DynamicWidgetStateStore.performRemoteSync(widgetKey: key, forceRefresh: true)
26
27
  } else {
27
- DynamicWidgetStateStore.handleAction(actionId)
28
+ let updatedState = DynamicWidgetStateStore.handleAction(actionId)
29
+ if DynamicWidgetStateStore.isCounterAction(actionId),
30
+ let newCounter = updatedState.remoteVariables?["counter"] {
31
+ for activity in Activity<DynamicActivityAttributes>.activities {
32
+ let oldJson = activity.content.state.payloadJson
33
+ let updatedJson = DynamicWidgetStateStore.applyCounterReplacement(in: oldJson, counterValue: newCounter)
34
+ if updatedJson != oldJson {
35
+ let nextContentState = DynamicActivityAttributes.ContentState(payloadJson: updatedJson)
36
+ await activity.update(
37
+ ActivityContent(
38
+ state: nextContentState,
39
+ staleDate: activity.content.staleDate,
40
+ relevanceScore: activity.content.relevanceScore
41
+ )
42
+ )
43
+ }
44
+ }
45
+ }
28
46
  }
29
47
 
30
48
  // Thông báo cho Main App nếu đang chạy ngầm hoặc nền
@@ -32,6 +50,43 @@ public struct DynamicWidgetActionIntent: AppIntent {
32
50
  CFNotificationCenterPostNotification(center, CFNotificationName("rn_live_widgets_action_clicked" as CFString), nil, nil, true)
33
51
 
34
52
  WidgetCenter.shared.reloadAllTimelines()
53
+ if #available(iOS 18.0, *) {
54
+ ControlCenter.shared.reloadAllControls()
55
+ }
56
+ return .result()
57
+ }
58
+ }
59
+
60
+ @available(iOS 18.0, *)
61
+ public struct DynamicControlToggleIntent: SetValueIntent {
62
+ public static var title: LocalizedStringResource = "Toggle Control Widget"
63
+ public static var description = IntentDescription("Toggle interactive Control Center widget state.")
64
+
65
+ @Parameter(title: "Action ID")
66
+ public var actionId: String
67
+
68
+ @Parameter(title: "Value")
69
+ public var value: Bool
70
+
71
+ public init() {
72
+ self.actionId = ""
73
+ self.value = false
74
+ }
75
+
76
+ public init(actionId: String, value: Bool = false) {
77
+ self.actionId = actionId
78
+ self.value = value
79
+ }
80
+
81
+ public func perform() async throws -> some IntentResult {
82
+ let key = actionId.hasPrefix("toggle:") ? String(actionId.dropFirst(7)) : actionId
83
+ DynamicWidgetStateStore.setToggle(key, value: value)
84
+
85
+ let center = CFNotificationCenterGetDarwinNotifyCenter()
86
+ CFNotificationCenterPostNotification(center, CFNotificationName("rn_live_widgets_action_clicked" as CFString), nil, nil, true)
87
+
88
+ WidgetCenter.shared.reloadAllTimelines()
89
+ ControlCenter.shared.reloadAllControls()
35
90
  return .result()
36
91
  }
37
92
  }
@@ -21,17 +21,47 @@ public struct DynamicPayloadDTO: Codable {
21
21
  public let lockScreen: LayoutNodeDTO?
22
22
  public let dynamicIsland: DynamicIslandDTO?
23
23
  public let staleTimestamp: Double?
24
+ public let staleLockScreen: LayoutNodeDTO?
25
+ public let staleDynamicIsland: DynamicIslandDTO?
26
+ public let expiredLockScreen: LayoutNodeDTO?
27
+ public let relevanceScore: Double?
28
+ public let scheduledEndTimestamp: Double?
29
+ public let autoEndAfterSeconds: Double?
30
+ public let expiredDismissalPolicy: String?
31
+ public let alertTitle: String?
32
+ public let alertBody: String?
33
+ public let alertSound: String?
24
34
 
25
35
  public init(
26
36
  activityId: String? = nil,
27
37
  lockScreen: LayoutNodeDTO? = nil,
28
38
  dynamicIsland: DynamicIslandDTO? = nil,
29
- staleTimestamp: Double? = nil
39
+ staleTimestamp: Double? = nil,
40
+ staleLockScreen: LayoutNodeDTO? = nil,
41
+ staleDynamicIsland: DynamicIslandDTO? = nil,
42
+ expiredLockScreen: LayoutNodeDTO? = nil,
43
+ relevanceScore: Double? = nil,
44
+ scheduledEndTimestamp: Double? = nil,
45
+ autoEndAfterSeconds: Double? = nil,
46
+ expiredDismissalPolicy: String? = nil,
47
+ alertTitle: String? = nil,
48
+ alertBody: String? = nil,
49
+ alertSound: String? = nil
30
50
  ) {
31
51
  self.activityId = activityId
32
52
  self.lockScreen = lockScreen
33
53
  self.dynamicIsland = dynamicIsland
34
54
  self.staleTimestamp = staleTimestamp
55
+ self.staleLockScreen = staleLockScreen
56
+ self.staleDynamicIsland = staleDynamicIsland
57
+ self.expiredLockScreen = expiredLockScreen
58
+ self.relevanceScore = relevanceScore
59
+ self.scheduledEndTimestamp = scheduledEndTimestamp
60
+ self.autoEndAfterSeconds = autoEndAfterSeconds
61
+ self.expiredDismissalPolicy = expiredDismissalPolicy
62
+ self.alertTitle = alertTitle
63
+ self.alertBody = alertBody
64
+ self.alertSound = alertSound
35
65
  }
36
66
  }
37
67
 
@@ -79,6 +109,8 @@ public struct WidgetSinglePageDTO: Codable {
79
109
  public let small: LayoutNodeDTO?
80
110
  public let medium: LayoutNodeDTO?
81
111
  public let large: LayoutNodeDTO?
112
+ public let extraLarge: LayoutNodeDTO?
113
+ public let standBy: LayoutNodeDTO?
82
114
  public let accessoryRectangular: LayoutNodeDTO?
83
115
  public let accessoryCircular: LayoutNodeDTO?
84
116
  public let accessoryInline: LayoutNodeDTO?
@@ -91,6 +123,8 @@ public struct WidgetMultiPagePayloadDTO: Codable {
91
123
  public let small: LayoutNodeDTO?
92
124
  public let medium: LayoutNodeDTO?
93
125
  public let large: LayoutNodeDTO?
126
+ public let extraLarge: LayoutNodeDTO?
127
+ public let standBy: LayoutNodeDTO?
94
128
  public let accessoryRectangular: LayoutNodeDTO?
95
129
  public let accessoryCircular: LayoutNodeDTO?
96
130
  public let accessoryInline: LayoutNodeDTO?
@@ -101,6 +135,19 @@ public struct WidgetMultiPagePayloadDTO: Codable {
101
135
  public let containerBackground: WidgetContainerBackgroundDTO?
102
136
  }
103
137
 
138
+ public struct ControlWidgetConfigDTO: Codable {
139
+ public let type: String?
140
+ public let title: String
141
+ public let subtitle: String?
142
+ public let checkedTitle: String?
143
+ public let checkedSubtitle: String?
144
+ public let systemName: String?
145
+ public let tintColor: String?
146
+ public let checked: Bool?
147
+ public let actionId: String
148
+ public let deepLink: String?
149
+ }
150
+
104
151
  public struct WidgetContainerBackgroundDTO: Codable {
105
152
  public let backgroundColor: AnyCodable?
106
153
  public let gradientColors: [String]?
@@ -119,10 +166,46 @@ public struct WidgetTimelineConfigDTO: Codable {
119
166
  public let afterDate: Double?
120
167
  }
121
168
 
122
- public struct WidgetRemoteConfigDTO: Codable {
169
+ public struct WidgetDataSchemaDTO: Codable {
170
+ public let requiredKeys: [String]?
171
+ public let types: [String: String]?
172
+ public let defaults: [String: AnyCodable]?
173
+ }
174
+
175
+ public struct WidgetAuthRefreshConfigDTO: Codable {
176
+ public let url: String
177
+ public let method: String?
178
+ public let headers: [String: String]?
179
+ public let body: AnyCodable?
180
+ public let tokenPath: String?
181
+ public let headerName: String?
182
+ public let headerPrefix: String?
183
+ }
184
+
185
+ public struct WidgetRemoteSourceConfigDTO: Codable {
123
186
  public let url: String
124
187
  public let method: String?
125
188
  public let headers: [String: String]?
189
+ public let body: AnyCodable?
190
+ public let timeoutMs: Int?
191
+ public let enableETag: Bool?
192
+ }
193
+
194
+ public struct WidgetRemoteConfigDTO: Codable {
195
+ public let url: String?
196
+ public let method: String?
197
+ public let headers: [String: String]?
198
+ public let body: AnyCodable?
199
+ public let timeoutMs: Int?
200
+ public let cacheTtlSeconds: Int?
201
+ public let enableETag: Bool?
202
+ public let maxRetries: Int?
203
+ public let retryDelayMs: Int?
204
+ public let sources: [String: WidgetRemoteSourceConfigDTO]?
205
+ public let mapping: [String: String]?
206
+ public let schema: WidgetDataSchemaDTO?
207
+ public let authRefresh: WidgetAuthRefreshConfigDTO?
208
+ public let errorFallback: LayoutNodeDTO?
126
209
  public let refreshIntervalMinutes: Int?
127
210
  public let intervalMinutes: Int?
128
211
 
@@ -136,26 +219,47 @@ public struct InteractiveWidgetState: Codable {
136
219
  public var pageOrder: [String]?
137
220
  public var toggledItems: [String: Bool]
138
221
  public var lastActionId: String?
222
+ public var actionUpdatedAt: Double?
139
223
  public var lastSyncTime: String?
140
224
  public var remoteVariables: [String: String]?
141
225
  public var updatedAt: Double
226
+ public var etags: [String: String]?
227
+ public var lastModified: [String: String]?
228
+ public var syncStatus: String?
229
+ public var lastSyncError: String?
230
+ public var lastHttpStatus: Int?
231
+ public var accessToken: String?
142
232
 
143
233
  public init(
144
234
  activePage: String? = nil,
145
235
  pageOrder: [String]? = nil,
146
236
  toggledItems: [String: Bool] = [:],
147
237
  lastActionId: String? = nil,
238
+ actionUpdatedAt: Double? = nil,
148
239
  lastSyncTime: String? = nil,
149
240
  remoteVariables: [String: String]? = nil,
150
- updatedAt: Double = Date().timeIntervalSince1970
241
+ updatedAt: Double = Date().timeIntervalSince1970,
242
+ etags: [String: String]? = nil,
243
+ lastModified: [String: String]? = nil,
244
+ syncStatus: String? = nil,
245
+ lastSyncError: String? = nil,
246
+ lastHttpStatus: Int? = nil,
247
+ accessToken: String? = nil
151
248
  ) {
152
249
  self.activePage = activePage
153
250
  self.pageOrder = pageOrder
154
251
  self.toggledItems = toggledItems
155
252
  self.lastActionId = lastActionId
253
+ self.actionUpdatedAt = actionUpdatedAt
156
254
  self.lastSyncTime = lastSyncTime
157
255
  self.remoteVariables = remoteVariables
158
256
  self.updatedAt = updatedAt
257
+ self.etags = etags
258
+ self.lastModified = lastModified
259
+ self.syncStatus = syncStatus
260
+ self.lastSyncError = lastSyncError
261
+ self.lastHttpStatus = lastHttpStatus
262
+ self.accessToken = accessToken
159
263
  }
160
264
  }
161
265
 
@@ -228,7 +332,13 @@ public struct AnyCodable: Codable {
228
332
  }
229
333
 
230
334
  public var stringValue: String? { value as? String }
231
- public var doubleValue: Double? { value as? Double }
335
+ public var doubleValue: Double? {
336
+ if let d = value as? Double { return d }
337
+ if let i = value as? Int { return Double(i) }
338
+ if let n = value as? NSNumber { return n.doubleValue }
339
+ if let s = value as? String { return Double(s.trimmingCharacters(in: .whitespaces)) }
340
+ return nil
341
+ }
232
342
  public var boolValue: Bool? { value as? Bool }
233
343
  public var arrayValue: [Any]? { value as? [Any] }
234
344
  public var doubleArrayValue: [Double]? {
@@ -144,13 +144,17 @@ public struct DynamicNodeView: View {
144
144
  let shadowX = (shadowOffsetDict?["x"] as? Double).map { CGFloat($0) } ?? 0
145
145
  let shadowY = (shadowOffsetDict?["y"] as? Double).map { CGFloat($0) } ?? 1
146
146
 
147
+ let isAccentable = node.props?["widgetAccentable"]?.boolValue == true
148
+
147
149
  if #available(iOS 16.0, *), numericAnimation {
148
150
  textNode
149
151
  .contentTransition(.numericText())
150
152
  .shadow(color: shadowColor ?? .clear, radius: shadowRad, x: shadowX, y: shadowY)
153
+ .applyWidgetAccentable(isAccentable)
151
154
  } else {
152
155
  textNode
153
156
  .shadow(color: shadowColor ?? .clear, radius: shadowRad, x: shadowX, y: shadowY)
157
+ .applyWidgetAccentable(isAccentable)
154
158
  }
155
159
  }
156
160
 
@@ -194,14 +198,18 @@ public struct DynamicNodeView: View {
194
198
  @ViewBuilder
195
199
  private func renderProgress() -> some View {
196
200
  let style = node.props?["style"]?.stringValue ?? "bar"
201
+ let isAccentable = node.props?["widgetAccentable"]?.boolValue == true
197
202
 
198
- if style == "segmented" {
199
- renderSegmentedProgress()
200
- } else if style == "circular" {
201
- renderCircularProgress()
202
- } else {
203
- renderBarProgress()
203
+ Group {
204
+ if style == "segmented" {
205
+ renderSegmentedProgress()
206
+ } else if style == "circular" {
207
+ renderCircularProgress()
208
+ } else {
209
+ renderBarProgress()
210
+ }
204
211
  }
212
+ .applyWidgetAccentable(isAccentable)
205
213
  }
206
214
 
207
215
  @ViewBuilder
@@ -628,6 +636,7 @@ public struct DynamicNodeView: View {
628
636
  .offset(y: size * 0.04)
629
637
  }
630
638
  .frame(width: size, height: size)
639
+ .applyWidgetAccentable(node.props?["widgetAccentable"]?.boolValue == true)
631
640
  }
632
641
 
633
642
  @ViewBuilder