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,435 @@
1
+ import SwiftUI
2
+ import WidgetKit
3
+
4
+ public struct DynamicWidgetEntry: TimelineEntry {
5
+ public let date: Date
6
+ public let layoutJson: String?
7
+
8
+ public init(date: Date, layoutJson: String?) {
9
+ self.date = date
10
+ self.layoutJson = layoutJson
11
+ }
12
+ }
13
+
14
+ public struct DynamicWidgetProvider: TimelineProvider {
15
+ let widgetKey: String
16
+ let appGroup: String
17
+
18
+ public init(widgetKey: String, appGroup: String = "") {
19
+ self.widgetKey = widgetKey
20
+ self.appGroup = appGroup
21
+ }
22
+
23
+ public func placeholder(in context: Context) -> DynamicWidgetEntry {
24
+ DynamicWidgetEntry(date: Date(), layoutJson: readLayoutJson())
25
+ }
26
+
27
+ public func getSnapshot(in context: Context, completion: @escaping (DynamicWidgetEntry) -> Void) {
28
+ let json = readLayoutJson()
29
+ completion(DynamicWidgetEntry(date: Date(), layoutJson: json))
30
+ }
31
+
32
+ public func getTimeline(in context: Context, completion: @escaping (Timeline<DynamicWidgetEntry>) -> Void) {
33
+ let wKey = widgetKey
34
+ let group = appGroup
35
+
36
+ // 1. Kiểm tra xem có cấu hình Timeline nhiều mốc thời gian không (widget_timeline_<key>)
37
+ if let timelineRaw = Self.readSharedString(forKey: "widget_timeline_\(wKey)", appGroup: group),
38
+ let data = timelineRaw.data(using: .utf8),
39
+ let timelineDTO = try? JSONDecoder().decode(WidgetTimelineConfigDTO.self, from: data),
40
+ !timelineDTO.entries.isEmpty {
41
+ var entries: [DynamicWidgetEntry] = []
42
+ for item in timelineDTO.entries {
43
+ let entryDate: Date
44
+ if item.date > 10_000_000_000 {
45
+ entryDate = Date(timeIntervalSince1970: item.date / 1000.0)
46
+ } else {
47
+ entryDate = Date(timeIntervalSince1970: item.date)
48
+ }
49
+ let layoutJson: String
50
+ if let encoded = try? JSONEncoder().encode(item.layout),
51
+ let str = String(data: encoded, encoding: .utf8) {
52
+ layoutJson = str
53
+ } else {
54
+ layoutJson = ""
55
+ }
56
+ entries.append(DynamicWidgetEntry(date: entryDate, layoutJson: layoutJson))
57
+ }
58
+
59
+ entries.sort { $0.date < $1.date }
60
+
61
+ let policy: TimelineReloadPolicy
62
+ switch timelineDTO.policy {
63
+ case "never":
64
+ policy = .never
65
+ case "afterDate":
66
+ if let after = timelineDTO.afterDate {
67
+ let afterDate = after > 10_000_000_000 ? Date(timeIntervalSince1970: after / 1000.0) : Date(timeIntervalSince1970: after)
68
+ policy = .after(afterDate)
69
+ } else {
70
+ policy = .atEnd
71
+ }
72
+ default:
73
+ policy = .atEnd
74
+ }
75
+
76
+ completion(Timeline(entries: entries, policy: policy))
77
+ return
78
+ }
79
+
80
+ // 2. Chạy cơ chế đơn mốc mặc định (Layout snapshot hiện tại)
81
+ let rawLayout = Self.readSharedString(forKey: "widget_layout_\(wKey)", appGroup: group)
82
+ let hasTemplateVars = rawLayout?.contains("{{") == true
83
+ let hasRemoteConfig = Self.readSharedString(forKey: "widget_remote_config_\(wKey)", appGroup: group) != nil
84
+ let state = DynamicWidgetStateStore.loadState()
85
+ let secondsSinceLastUpdate = Date().timeIntervalSince1970 - (state.updatedAt ?? 0)
86
+ let needsRemoteSync = hasRemoteConfig && hasTemplateVars && (state.lastSyncTime == nil || secondsSinceLastUpdate >= 20)
87
+ let needsImagePrefetch = rawLayout.map { DynamicWidgetImageCache.hasUncachedUrls(in: $0) } ?? false
88
+
89
+ // Trả Timeline ngay lập tức để chuyển đổi giữa các mẫu Widget mượt mà tức thì
90
+ let json = readLayoutJson()
91
+ let entry = DynamicWidgetEntry(date: Date(), layoutJson: json)
92
+ let intervalMins = readRefreshIntervalMinutes()
93
+ let nextUpdate = Calendar.current.date(byAdding: .minute, value: intervalMins, to: Date())!
94
+ completion(Timeline(entries: [entry], policy: .after(nextUpdate)))
95
+
96
+ // Tác vụ đồng bộ ngầm và tải trước ảnh URL nếu cần
97
+ if needsRemoteSync || needsImagePrefetch {
98
+ Task {
99
+ if needsRemoteSync {
100
+ await DynamicWidgetStateStore.performRemoteSync(widgetKey: wKey)
101
+ }
102
+ if let json = json, needsImagePrefetch {
103
+ await DynamicWidgetImageCache.prefetchUrls(in: json)
104
+ }
105
+ }
106
+ }
107
+ }
108
+
109
+ private func readRefreshIntervalMinutes() -> Int {
110
+ let configKey = "widget_remote_config_\(widgetKey)"
111
+ if let json = Self.readSharedString(forKey: configKey, appGroup: appGroup),
112
+ let data = json.data(using: .utf8),
113
+ let config = try? JSONDecoder().decode(WidgetRemoteConfigDTO.self, from: data),
114
+ let mins = config.refreshIntervalMinutes, mins >= 1 {
115
+ return mins
116
+ }
117
+ return 15
118
+ }
119
+
120
+ private func readLayoutJson() -> String? {
121
+ let key = "widget_layout_\(widgetKey)"
122
+ var raw: String? = Self.readSharedString(forKey: key, appGroup: appGroup)
123
+ if raw == nil && widgetKey != "main" {
124
+ raw = Self.readSharedString(forKey: "widget_layout_main", appGroup: appGroup)
125
+ }
126
+ guard var raw = raw else {
127
+ return nil
128
+ }
129
+
130
+ let state = DynamicWidgetStateStore.loadState()
131
+ let syncTime = state.lastSyncTime ?? {
132
+ let f = DateFormatter()
133
+ f.dateFormat = "HH:mm:ss"
134
+ return f.string(from: Date())
135
+ }()
136
+ raw = raw.replacingOccurrences(of: "{{_lastSyncTime}}", with: syncTime)
137
+
138
+ if let vars = state.remoteVariables {
139
+ for (k, v) in vars {
140
+ let escaped = v.replacingOccurrences(of: "\"", with: "\\\"")
141
+ raw = raw.replacingOccurrences(of: "{{\(k)}}", with: escaped)
142
+ }
143
+ }
144
+
145
+ if let selectedConfig = Self.readSharedString(forKey: "widget_selected_config_\(widgetKey)", appGroup: appGroup) {
146
+ raw = raw.replacingOccurrences(of: "{{_selectedConfigId}}", with: selectedConfig)
147
+ raw = raw.replacingOccurrences(of: "{{selectedConfigId}}", with: selectedConfig)
148
+ }
149
+ return raw
150
+ }
151
+
152
+ public static func readSharedString(forKey key: String, appGroup: String) -> String? {
153
+ let resolvedGroup = resolveAppGroup(appGroup)
154
+
155
+ if let fileURL = sharedFileURL(key: key, appGroup: appGroup),
156
+ let fileVal = try? String(contentsOf: fileURL, encoding: .utf8),
157
+ !fileVal.isEmpty {
158
+ return fileVal
159
+ }
160
+
161
+ if !resolvedGroup.isEmpty,
162
+ let groupDefaults = UserDefaults(suiteName: resolvedGroup),
163
+ let val = groupDefaults.string(forKey: key),
164
+ !val.isEmpty {
165
+ return val
166
+ }
167
+
168
+ #if targetEnvironment(simulator)
169
+ let simPath = "/tmp/rn_live_widgets_\(key).json"
170
+ if let simVal = try? String(contentsOfFile: simPath, encoding: .utf8), !simVal.isEmpty {
171
+ return simVal
172
+ }
173
+ #endif
174
+
175
+ return UserDefaults.standard.string(forKey: key)
176
+ }
177
+
178
+ public static func writeSharedString(_ value: String, forKey key: String, appGroup: String) {
179
+ let resolvedGroup = resolveAppGroup(appGroup)
180
+ if let fileURL = sharedFileURL(key: key, appGroup: appGroup) {
181
+ try? value.write(to: fileURL, atomically: true, encoding: .utf8)
182
+ }
183
+ if !resolvedGroup.isEmpty, let groupDefaults = UserDefaults(suiteName: resolvedGroup) {
184
+ groupDefaults.set(value, forKey: key)
185
+ groupDefaults.synchronize()
186
+ }
187
+ #if targetEnvironment(simulator)
188
+ let simPath = "/tmp/rn_live_widgets_\(key).json"
189
+ try? value.write(toFile: simPath, atomically: true, encoding: .utf8)
190
+ #endif
191
+ }
192
+
193
+ public static func sharedFileURL(key: String, appGroup: String) -> URL? {
194
+ let resolvedGroup = resolveAppGroup(appGroup)
195
+ guard !resolvedGroup.isEmpty,
196
+ let containerURL = FileManager.default.containerURL(forSecurityApplicationGroupIdentifier: resolvedGroup) else {
197
+ return nil
198
+ }
199
+ return containerURL.appendingPathComponent("rn_live_widgets_\(key).json")
200
+ }
201
+
202
+ public static func resolveAppGroup(_ explicit: String) -> String {
203
+ if !explicit.isEmpty { return explicit }
204
+ guard let bundleId = Bundle.main.bundleIdentifier else { return "" }
205
+ if Bundle.main.bundlePath.hasSuffix(".appex"),
206
+ let dotIndex = bundleId.lastIndex(of: ".") {
207
+ let hostBundleId = String(bundleId[..<dotIndex])
208
+ return "group.\(hostBundleId)"
209
+ }
210
+ return "group.\(bundleId)"
211
+ }
212
+ }
213
+
214
+ public struct DynamicHomeScreenWidgetView: View {
215
+ @Environment(\.widgetFamily) var family
216
+ @Environment(\.colorScheme) var colorScheme
217
+ let entry: DynamicWidgetEntry
218
+
219
+ public init(entry: DynamicWidgetEntry) {
220
+ self.entry = entry
221
+ }
222
+
223
+ private var parsedPayload: WidgetMultiPagePayloadDTO? {
224
+ guard let json = entry.layoutJson,
225
+ let data = json.data(using: .utf8),
226
+ let payload = try? JSONDecoder().decode(WidgetMultiPagePayloadDTO.self, from: data) else {
227
+ return nil
228
+ }
229
+ return payload
230
+ }
231
+
232
+ private var rootDeepLink: String? {
233
+ parsedPayload?.rootDeepLink
234
+ }
235
+
236
+ private var containerGradientColors: [String]? {
237
+ parsedPayload?.containerBackground?.gradientColors
238
+ }
239
+
240
+ private var activeNode: LayoutNodeDTO? {
241
+ guard let payload = parsedPayload else {
242
+ return nil
243
+ }
244
+
245
+ if let pages = payload.pages, !pages.isEmpty {
246
+ let state = DynamicWidgetStateStore.loadState()
247
+ let defaultOrder = payload.pageOrder ?? Array(pages.keys).sorted()
248
+ let activePageId: String = {
249
+ if let saved = state.activePage, pages[saved] != nil {
250
+ return saved
251
+ }
252
+ if let initial = payload.initialPage, pages[initial] != nil {
253
+ return initial
254
+ }
255
+ return defaultOrder.first ?? ""
256
+ }()
257
+
258
+ if let pageConfig = pages[activePageId] {
259
+ return selectFamilyNode(
260
+ small: pageConfig.small ?? payload.small,
261
+ medium: pageConfig.medium ?? payload.medium,
262
+ large: pageConfig.large ?? payload.large,
263
+ accessoryRectangular: pageConfig.accessoryRectangular ?? payload.accessoryRectangular,
264
+ accessoryCircular: pageConfig.accessoryCircular ?? payload.accessoryCircular,
265
+ accessoryInline: pageConfig.accessoryInline ?? payload.accessoryInline
266
+ )
267
+ }
268
+ }
269
+
270
+ return selectFamilyNode(
271
+ small: payload.small,
272
+ medium: payload.medium,
273
+ large: payload.large,
274
+ accessoryRectangular: payload.accessoryRectangular,
275
+ accessoryCircular: payload.accessoryCircular,
276
+ accessoryInline: payload.accessoryInline
277
+ )
278
+ }
279
+
280
+ private func selectFamilyNode(
281
+ small: LayoutNodeDTO?,
282
+ medium: LayoutNodeDTO?,
283
+ large: LayoutNodeDTO?,
284
+ accessoryRectangular: LayoutNodeDTO? = nil,
285
+ accessoryCircular: LayoutNodeDTO? = nil,
286
+ accessoryInline: LayoutNodeDTO? = nil
287
+ ) -> LayoutNodeDTO? {
288
+ if #available(iOS 16.0, *) {
289
+ switch family {
290
+ case .accessoryRectangular:
291
+ return accessoryRectangular ?? small
292
+ case .accessoryCircular:
293
+ return accessoryCircular
294
+ case .accessoryInline:
295
+ return accessoryInline
296
+ default:
297
+ break
298
+ }
299
+ }
300
+
301
+ switch family {
302
+ case .systemSmall:
303
+ return small ?? medium ?? large
304
+ case .systemMedium:
305
+ return medium ?? small ?? large
306
+ case .systemLarge, .systemExtraLarge:
307
+ return large ?? medium ?? small
308
+ default:
309
+ return small ?? medium ?? large
310
+ }
311
+ }
312
+
313
+ private var isAccessoryFamily: Bool {
314
+ if #available(iOS 16.0, *) {
315
+ return family == .accessoryRectangular || family == .accessoryCircular || family == .accessoryInline
316
+ }
317
+ return false
318
+ }
319
+
320
+ private var rootBackgroundColor: Color {
321
+ if isAccessoryFamily {
322
+ return Color.clear
323
+ }
324
+ if let bgCodable = parsedPayload?.containerBackground?.backgroundColor,
325
+ let color = Color.resolve(from: bgCodable, colorScheme: colorScheme) {
326
+ return color
327
+ }
328
+ if let bgCodable = activeNode?.props?["backgroundColor"],
329
+ let color = Color.resolve(from: bgCodable, colorScheme: colorScheme) {
330
+ return color
331
+ }
332
+ return Color(.systemBackground)
333
+ }
334
+
335
+ public var body: some View {
336
+ Group {
337
+ if let node = activeNode {
338
+ DynamicNodeView(node: node)
339
+ .frame(
340
+ maxWidth: .infinity,
341
+ maxHeight: .infinity,
342
+ alignment: isAccessoryFamily ? .center : .topLeading
343
+ )
344
+ } else {
345
+ fallbackView()
346
+ }
347
+ }
348
+ .applyWidgetURL(rootDeepLink)
349
+ .applyWidgetBackground(rootBackgroundColor, gradientColors: containerGradientColors, isAccessory: isAccessoryFamily)
350
+ }
351
+
352
+ @ViewBuilder
353
+ private func fallbackView() -> some View {
354
+ if isAccessoryFamily {
355
+ if family == .accessoryCircular {
356
+ Image(systemName: "clock.badge.checkmark.fill")
357
+ .font(.system(size: 22, weight: .bold))
358
+ .foregroundColor(.white)
359
+ } else {
360
+ VStack(alignment: .leading, spacing: 2) {
361
+ Text("Live Widgets")
362
+ .font(.caption2.weight(.bold))
363
+ Text("Chưa có dữ liệu")
364
+ .font(.system(size: 9))
365
+ .foregroundColor(.secondary)
366
+ }
367
+ }
368
+ } else {
369
+ VStack(spacing: 6) {
370
+ Text("Live Widgets")
371
+ .font(.headline)
372
+ Text("Chọn 1 mẫu UI trong app để hiển thị")
373
+ .font(.caption)
374
+ .foregroundColor(.secondary)
375
+ .multilineTextAlignment(.center)
376
+ }
377
+ .padding(12)
378
+ }
379
+ }
380
+ }
381
+
382
+ extension View {
383
+ @ViewBuilder
384
+ func applyWidgetURL(_ urlString: String?) -> some View {
385
+ if let urlStr = urlString, let url = URL(string: urlStr) {
386
+ self.widgetURL(url)
387
+ } else {
388
+ self
389
+ }
390
+ }
391
+
392
+ /// Tương thích iOS 17+ / iOS 18+: Bắt buộc dùng `containerBackground(for: .widget)`
393
+ @ViewBuilder
394
+ func applyWidgetBackground(
395
+ _ color: Color,
396
+ gradientColors: [String]? = nil,
397
+ isAccessory: Bool = false
398
+ ) -> some View {
399
+ if #available(iOS 17.0, *) {
400
+ if isAccessory {
401
+ self.containerBackground(for: .widget) {
402
+ Color.clear
403
+ }
404
+ } else {
405
+ self.containerBackground(for: .widget) {
406
+ if let grad = gradientColors, grad.count >= 2 {
407
+ LinearGradient(
408
+ colors: grad.compactMap { Color(hex: $0) },
409
+ startPoint: .topLeading,
410
+ endPoint: .bottomTrailing
411
+ )
412
+ } else {
413
+ color
414
+ }
415
+ }
416
+ }
417
+ } else {
418
+ if isAccessory {
419
+ self
420
+ } else {
421
+ if let grad = gradientColors, grad.count >= 2 {
422
+ self.padding().background(
423
+ LinearGradient(
424
+ colors: grad.compactMap { Color(hex: $0) },
425
+ startPoint: .topLeading,
426
+ endPoint: .bottomTrailing
427
+ )
428
+ )
429
+ } else {
430
+ self.padding().background(color)
431
+ }
432
+ }
433
+ }
434
+ }
435
+ }
@@ -0,0 +1,79 @@
1
+ import ActivityKit
2
+ import SwiftUI
3
+ import WidgetKit
4
+
5
+ @available(iOS 16.1, *)
6
+ public struct DynamicLiveActivityWidget: Widget {
7
+ public init() {}
8
+
9
+ public var body: some WidgetConfiguration {
10
+ ActivityConfiguration(for: DynamicActivityAttributes.self) { context in
11
+ // Render Lock Screen
12
+ let payload = parsePayload(json: context.state.payloadJson)
13
+ if let lockScreen = payload?.lockScreen {
14
+ DynamicNodeView(node: lockScreen)
15
+ .activityBackgroundTint(.black.opacity(0.8))
16
+ .activitySystemActionForegroundColor(.white)
17
+ } else {
18
+ Text("Live Activity")
19
+ }
20
+ } dynamicIsland: { context in
21
+ let payload = parsePayload(json: context.state.payloadJson)
22
+ let island = payload?.dynamicIsland
23
+
24
+ return DynamicIsland {
25
+ // Expanded Regions với Safe Padding & Smart Fallback tránh tình trạng Dynamic Island bị đen trống rỗng
26
+ DynamicIslandExpandedRegion(.leading) {
27
+ if let leading = island?.expanded?.leading ?? island?.compactLeading {
28
+ DynamicNodeView(node: leading)
29
+ .padding(.leading, 6)
30
+ .padding(.top, 4)
31
+ }
32
+ }
33
+ DynamicIslandExpandedRegion(.trailing) {
34
+ if let trailing = island?.expanded?.trailing ?? island?.compactTrailing {
35
+ DynamicNodeView(node: trailing)
36
+ .padding(.trailing, 6)
37
+ .padding(.top, 4)
38
+ }
39
+ }
40
+ DynamicIslandExpandedRegion(.bottom) {
41
+ if let bottom = island?.expanded?.bottom ?? payload?.lockScreen {
42
+ DynamicNodeView(node: bottom)
43
+ .padding(.horizontal, 8)
44
+ .padding(.bottom, 6)
45
+ }
46
+ }
47
+ DynamicIslandExpandedRegion(.center) {
48
+ if let center = island?.expanded?.center {
49
+ DynamicNodeView(node: center)
50
+ .padding(.top, 4)
51
+ }
52
+ }
53
+ } compactLeading: {
54
+ if let leading = island?.compactLeading {
55
+ DynamicNodeView(node: leading)
56
+ .fixedSize(horizontal: true, vertical: false)
57
+ .padding(.leading, 2)
58
+ }
59
+ } compactTrailing: {
60
+ if let trailing = island?.compactTrailing {
61
+ DynamicNodeView(node: trailing)
62
+ .fixedSize(horizontal: true, vertical: false)
63
+ .padding(.trailing, 2)
64
+ }
65
+ } minimal: {
66
+ if let minimal = island?.minimal ?? island?.compactLeading {
67
+ DynamicNodeView(node: minimal)
68
+ .fixedSize(horizontal: true, vertical: false)
69
+ }
70
+ }
71
+ }
72
+ }
73
+
74
+ private func parsePayload(json: String) -> DynamicPayloadDTO? {
75
+ guard let data = json.data(using: .utf8) else { return nil }
76
+ return try? JSONDecoder().decode(DynamicPayloadDTO.self, from: data)
77
+ }
78
+ }
79
+
@@ -0,0 +1,60 @@
1
+ import { BadgeNode, ButtonNode, ChartNode, ContainerProps, CustomNode, DividerNode, EqualizerNode, EqualizerProps, GaugeNode, GridNode, GridProps, HStackNode, ImageNode, LayoutNode, LinkNode, LinkProps, ProgressNode, SpacerNode, StyleProp, TextNode, TextStyle, TimerNode, ToggleNode, VStackNode, ZStackNode, ZStackProps } from './types';
2
+ export declare function flattenStyle<T extends object>(...styles: StyleProp<T>[]): T | undefined;
3
+ export type AnyWidgetStyle = TextStyle | ContainerProps | Record<string, any>;
4
+ export type NamedStyles<T> = {
5
+ [P in keyof T]: AnyWidgetStyle;
6
+ };
7
+ export declare const StyleSheet: {
8
+ create: <T extends NamedStyles<T> | NamedStyles<any>>(styles: T & NamedStyles<any>) => T;
9
+ flatten: typeof flattenStyle;
10
+ };
11
+ /**
12
+ * Các hàm helper tạo node cây giao diện trực quan cho TypeScript/JavaScript
13
+ */
14
+ export declare const UI: {
15
+ StyleSheet: {
16
+ create: <T extends NamedStyles<T> | NamedStyles<any>>(styles: T & NamedStyles<any>) => T;
17
+ flatten: typeof flattenStyle;
18
+ };
19
+ VStack: (propsOrChildren?: StyleProp<ContainerProps> | LayoutNode | LayoutNode[], ...children: LayoutNode[]) => VStackNode;
20
+ HStack: (propsOrChildren?: StyleProp<ContainerProps> | LayoutNode | LayoutNode[], ...children: LayoutNode[]) => HStackNode;
21
+ Text: (text: string, ...styles: StyleProp<TextStyle>[]) => TextNode;
22
+ Timer: (targetTimestamp: number, options?: {
23
+ mode?: "countdown" | "countup";
24
+ color?: string;
25
+ fontSize?: number;
26
+ fontWeight?: "regular" | "medium" | "semibold" | "bold";
27
+ prefix?: string;
28
+ suffix?: string;
29
+ }) => TimerNode;
30
+ Progress: (valueOrOptions: number | ProgressNode["props"], options?: Omit<ProgressNode["props"], "value">) => ProgressNode;
31
+ Image: (urlOrOptions: string | ImageNode["props"], options?: Omit<ImageNode["props"], "url">) => ImageNode;
32
+ Spacer: (minLength?: number) => SpacerNode;
33
+ Button: (titleOrProps: string | ButtonNode["props"], options?: Omit<ButtonNode["props"], "title">) => ButtonNode;
34
+ /**
35
+ * Tạo nút bấm kèm logic hàm TypeScript trực tiếp.
36
+ * Thư viện tự động sinh ActionId và kết nối bộ lắng nghe Native -> hàm async TypeScript của bạn!
37
+ */
38
+ ActionButton: (title: string, onPress: (payload?: any) => Promise<any> | any, options?: Omit<ButtonNode["props"], "title" | "actionId" | "onPress">) => ButtonNode;
39
+ ZStack: (propsOrChildren?: ZStackProps | LayoutNode | LayoutNode[], ...children: LayoutNode[]) => ZStackNode;
40
+ Grid: (propsOrChildren?: GridProps | LayoutNode | LayoutNode[], ...children: LayoutNode[]) => GridNode;
41
+ Divider: (options?: DividerNode["props"]) => DividerNode;
42
+ Gauge: (valueOrOptions: number | GaugeNode["props"], options?: Omit<GaugeNode["props"], "value">) => GaugeNode;
43
+ Chart: (valuesOrOptions: number[] | ChartNode["props"], options?: Omit<ChartNode["props"], "values">) => ChartNode;
44
+ Toggle: (labelOrOptions: string | ToggleNode["props"], options?: Omit<ToggleNode["props"], "label">) => ToggleNode;
45
+ Badge: (textOrOptions: string | BadgeNode["props"], options?: Omit<BadgeNode["props"], "text">) => BadgeNode;
46
+ Link: (props: LinkProps, ...children: LayoutNode[]) => LinkNode;
47
+ /**
48
+ * Khởi tạo một Component Native tùy chỉnh đã được đăng ký qua:
49
+ * - iOS (Swift): `DynamicNodeRegistry.shared.register("MyComponent") { node in ... }`
50
+ * - Android (Kotlin): `DynamicNodeRegistry.register("MyComponent", ...)`
51
+ */
52
+ Custom: (componentName: string, props?: Record<string, any>, ...children: LayoutNode[]) => CustomNode;
53
+ /**
54
+ * Component sóng nhạc chuyển động (Equalizer / Sound Visualizer):
55
+ * Tự động chạy animation nhịp sóng nhạc mượt mà trên Dynamic Island và Lock Screen (iOS)
56
+ * và hiển thị trực quan trên Android.
57
+ */
58
+ Equalizer: (options?: EqualizerProps) => EqualizerNode;
59
+ };
60
+ //# sourceMappingURL=builder.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"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"}