react-native-live-widgets 1.2.0 → 1.2.2
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/CHANGELOG.md +34 -0
- package/README.md +129 -50
- package/android/src/main/AndroidManifest.xml +12 -0
- package/android/src/main/assets/fonts/MaterialIcons-Regular.ttf +0 -0
- package/android/src/main/java/com/reactnativeliveactivity/bridge/LiveActivityModule.kt +61 -1
- package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityNotifier.kt +153 -17
- package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityReceiver.kt +1 -1
- package/android/src/main/java/com/reactnativeliveactivity/renderer/DynamicWidgetCanvasRenderer.kt +529 -59
- package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetImageCache.kt +53 -0
- package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetStateStore.kt +684 -83
- package/android/src/main/java/com/reactnativeliveactivity/widgets/DynamicHomeScreenWidgetProvider.kt +129 -57
- package/android/src/main/java/com/reactnativeliveactivity/widgets/DynamicQuickSettingsTileService.kt +120 -0
- package/android/src/main/res/layout/rn_live_widget_hit_zone.xml +16 -0
- package/android/src/main/res/layout/rn_live_widget_host.xml +16 -87
- package/app.plugin.js +36 -0
- package/assets/MaterialIcons.json +2236 -0
- package/cli/codegen.js +789 -0
- package/cli/setup.js +323 -63
- package/docs/EXPO-GUIDE-EN.md +21 -3
- package/docs/EXPO-GUIDE-VI.md +21 -3
- package/docs/GUIDE-EN.md +444 -21
- package/docs/GUIDE-VI.md +473 -22
- package/docs/index.html +2263 -265
- package/docs/llms-full.txt +41 -0
- package/docs/llms.txt +24 -7
- package/ios/Bridge/LiveActivityModule.swift +333 -44
- package/ios/Intents/DynamicWidgetActionIntent.swift +57 -2
- package/ios/Models/DynamicLayoutModels.swift +120 -5
- package/ios/Renderer/DynamicNodeView.swift +184 -20
- package/ios/Storage/DynamicWidgetStateStore.swift +649 -38
- package/ios/Widgets/DynamicControlWidget.swift +63 -0
- package/ios/Widgets/DynamicHomeScreenWidget.swift +104 -26
- package/ios/Widgets/DynamicLiveActivityWidget.swift +25 -4
- package/lib/builder.d.ts +50 -7
- package/lib/builder.d.ts.map +1 -1
- package/lib/builder.js +391 -29
- package/lib/builder.js.map +1 -1
- package/lib/dispatcher.js +16 -10
- package/lib/dispatcher.js.map +1 -1
- package/lib/hooks.d.ts +13 -9
- package/lib/hooks.d.ts.map +1 -1
- package/lib/hooks.js +105 -42
- package/lib/hooks.js.map +1 -1
- package/lib/index.d.ts +96 -8
- package/lib/index.d.ts.map +1 -1
- package/lib/index.js +415 -97
- package/lib/index.js.map +1 -1
- package/lib/ir.d.ts +15 -0
- package/lib/ir.d.ts.map +1 -0
- package/lib/ir.js +386 -0
- package/lib/ir.js.map +1 -0
- package/lib/jsx.d.ts +19 -7
- package/lib/jsx.d.ts.map +1 -1
- package/lib/jsx.js +179 -95
- package/lib/jsx.js.map +1 -1
- package/lib/material-icons.generated.d.ts +8 -0
- package/lib/material-icons.generated.d.ts.map +1 -0
- package/lib/material-icons.generated.js +9 -0
- package/lib/material-icons.generated.js.map +1 -0
- package/lib/preview.d.ts +11 -27
- package/lib/preview.d.ts.map +1 -1
- package/lib/preview.js +456 -119
- package/lib/preview.js.map +1 -1
- package/lib/sf-symbols.generated.d.ts +8 -0
- package/lib/sf-symbols.generated.d.ts.map +1 -0
- package/lib/sf-symbols.generated.js +9 -0
- package/lib/sf-symbols.generated.js.map +1 -0
- package/lib/types.d.ts +506 -30
- package/lib/types.d.ts.map +1 -1
- package/lib/types.js +2 -1
- package/lib/types.js.map +1 -1
- package/package.json +7 -2
- package/scripts/build.js +98 -0
- package/scripts/generate-material-icons.js +93 -0
- package/scripts/generate-sf-symbols.js +95 -0
- package/scripts/release.js +115 -0
- package/scripts/test-ir-semantic.js +314 -0
- package/src/builder.ts +439 -26
- package/src/hooks.ts +88 -12
- package/src/index.ts +385 -57
- package/src/ir.ts +436 -0
- package/src/jsx.tsx +99 -21
- package/src/material-icons.generated.ts +3844 -0
- package/src/preview.tsx +533 -55
- package/src/react-native-env.d.ts +1 -0
- package/src/sf-symbols.generated.ts +9533 -0
- package/src/types.ts +601 -31
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
import AppIntents
|
|
2
|
+
import SwiftUI
|
|
3
|
+
import WidgetKit
|
|
4
|
+
|
|
5
|
+
// MARK: - iOS 18+ Interactive Control Widgets (Control Center, Lock Screen & Action Button)
|
|
6
|
+
|
|
7
|
+
@available(iOS 18.0, *)
|
|
8
|
+
public enum ControlWidgetConfigReader {
|
|
9
|
+
public static func load(controlId: String = "main") -> ControlWidgetConfigDTO? {
|
|
10
|
+
guard let json = DynamicWidgetProvider.readSharedString(forKey: "widget_control_\(controlId)", appGroup: ""),
|
|
11
|
+
let data = json.data(using: .utf8) else {
|
|
12
|
+
return nil
|
|
13
|
+
}
|
|
14
|
+
return try? JSONDecoder().decode(ControlWidgetConfigDTO.self, from: data)
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
@available(iOS 18.0, *)
|
|
19
|
+
public struct DynamicControlWidget: ControlWidget {
|
|
20
|
+
public init() {}
|
|
21
|
+
|
|
22
|
+
public var body: some ControlWidgetConfiguration {
|
|
23
|
+
StaticControlConfiguration(kind: "DynamicControlWidget") {
|
|
24
|
+
let config = ControlWidgetConfigReader.load(controlId: "main")
|
|
25
|
+
let title = config?.title ?? "Live Widget"
|
|
26
|
+
let systemName = config?.systemName ?? "bolt.fill"
|
|
27
|
+
let actionId = config?.actionId ?? "control_action_main"
|
|
28
|
+
|
|
29
|
+
ControlWidgetButton(action: DynamicWidgetActionIntent(actionId: actionId)) {
|
|
30
|
+
Label(title, systemImage: systemName)
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
.displayName("Live Widgets Action")
|
|
34
|
+
.description("Kích hoạt nhanh hành động hoặc mở rộng Control Widget từ React Native.")
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
@available(iOS 18.0, *)
|
|
39
|
+
public struct DynamicControlToggleWidget: ControlWidget {
|
|
40
|
+
public init() {}
|
|
41
|
+
|
|
42
|
+
public var body: some ControlWidgetConfiguration {
|
|
43
|
+
StaticControlConfiguration(kind: "DynamicControlToggleWidget") {
|
|
44
|
+
let config = ControlWidgetConfigReader.load(controlId: "toggle")
|
|
45
|
+
?? ControlWidgetConfigReader.load(controlId: "main")
|
|
46
|
+
let rawActionId = config?.actionId ?? "toggle:control_main"
|
|
47
|
+
let key = rawActionId.hasPrefix("toggle:") ? String(rawActionId.dropFirst(7)) : rawActionId
|
|
48
|
+
let state = DynamicWidgetStateStore.loadState()
|
|
49
|
+
let isOn = state.toggledItems[key] ?? (config?.checked ?? false)
|
|
50
|
+
let title = isOn ? (config?.checkedTitle ?? config?.title ?? "Đang bật") : (config?.title ?? "Tạm tắt")
|
|
51
|
+
let systemName = config?.systemName ?? "checkmark.circle.fill"
|
|
52
|
+
|
|
53
|
+
ControlWidgetToggle(
|
|
54
|
+
isOn: isOn,
|
|
55
|
+
action: DynamicControlToggleIntent(actionId: rawActionId, value: !isOn)
|
|
56
|
+
) {
|
|
57
|
+
Label(title, systemImage: systemName)
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
.displayName("Live Widgets Toggle")
|
|
61
|
+
.description("Bật/tắt trạng thái đồng bộ trực tiếp với React Native SharedStorage.")
|
|
62
|
+
}
|
|
63
|
+
}
|
|
@@ -34,7 +34,9 @@ public struct DynamicWidgetProvider: TimelineProvider {
|
|
|
34
34
|
let group = appGroup
|
|
35
35
|
|
|
36
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
|
-
|
|
37
|
+
let timelineRaw = Self.readSharedString(forKey: "widget_timeline_\(wKey)", appGroup: group)
|
|
38
|
+
?? (wKey != "main" ? Self.readSharedString(forKey: "widget_timeline_main", appGroup: group) : nil)
|
|
39
|
+
if let timelineRaw = timelineRaw,
|
|
38
40
|
let data = timelineRaw.data(using: .utf8),
|
|
39
41
|
let timelineDTO = try? JSONDecoder().decode(WidgetTimelineConfigDTO.self, from: data),
|
|
40
42
|
!timelineDTO.entries.isEmpty {
|
|
@@ -79,11 +81,11 @@ public struct DynamicWidgetProvider: TimelineProvider {
|
|
|
79
81
|
|
|
80
82
|
// 2. Chạy cơ chế đơn mốc mặc định (Layout snapshot hiện tại)
|
|
81
83
|
let rawLayout = Self.readSharedString(forKey: "widget_layout_\(wKey)", appGroup: group)
|
|
82
|
-
let hasTemplateVars = rawLayout?.contains("{{") == true
|
|
83
84
|
let hasRemoteConfig = Self.readSharedString(forKey: "widget_remote_config_\(wKey)", appGroup: group) != nil
|
|
84
85
|
let state = DynamicWidgetStateStore.loadState()
|
|
85
|
-
let secondsSinceLastUpdate = Date().timeIntervalSince1970 -
|
|
86
|
-
let
|
|
86
|
+
let secondsSinceLastUpdate = Date().timeIntervalSince1970 - state.updatedAt
|
|
87
|
+
let effectiveTtl = Double(readCacheTtlSeconds())
|
|
88
|
+
let needsRemoteSync = hasRemoteConfig && (state.lastSyncTime == nil || secondsSinceLastUpdate >= effectiveTtl)
|
|
87
89
|
let needsImagePrefetch = rawLayout.map { DynamicWidgetImageCache.hasUncachedUrls(in: $0) } ?? false
|
|
88
90
|
|
|
89
91
|
// Trả Timeline ngay lập tức để chuyển đổi giữa các mẫu Widget mượt mà tức thì
|
|
@@ -106,46 +108,89 @@ public struct DynamicWidgetProvider: TimelineProvider {
|
|
|
106
108
|
}
|
|
107
109
|
}
|
|
108
110
|
|
|
109
|
-
private func
|
|
111
|
+
private func readRemoteConfig() -> WidgetRemoteConfigDTO? {
|
|
110
112
|
let configKey = "widget_remote_config_\(widgetKey)"
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
113
|
+
guard let json = Self.readSharedString(forKey: configKey, appGroup: appGroup),
|
|
114
|
+
let data = json.data(using: .utf8) else {
|
|
115
|
+
return nil
|
|
116
|
+
}
|
|
117
|
+
return try? JSONDecoder().decode(WidgetRemoteConfigDTO.self, from: data)
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
private func readRefreshIntervalMinutes() -> Int {
|
|
121
|
+
if let config = readRemoteConfig() {
|
|
114
122
|
return max(1, config.effectiveIntervalMinutes)
|
|
115
123
|
}
|
|
116
124
|
return 15
|
|
117
125
|
}
|
|
118
126
|
|
|
119
|
-
private func
|
|
120
|
-
let
|
|
121
|
-
|
|
122
|
-
if raw == nil && widgetKey != "main" {
|
|
123
|
-
raw = Self.readSharedString(forKey: "widget_layout_main", appGroup: appGroup)
|
|
124
|
-
}
|
|
125
|
-
guard var raw = raw else {
|
|
126
|
-
return nil
|
|
127
|
+
private func readCacheTtlSeconds() -> Int {
|
|
128
|
+
if let ttl = readRemoteConfig()?.cacheTtlSeconds {
|
|
129
|
+
return max(0, ttl)
|
|
127
130
|
}
|
|
131
|
+
return 20
|
|
132
|
+
}
|
|
128
133
|
|
|
134
|
+
private func readLayoutJson() -> String? {
|
|
129
135
|
let state = DynamicWidgetStateStore.loadState()
|
|
130
136
|
let syncTime = state.lastSyncTime ?? {
|
|
131
137
|
let f = DateFormatter()
|
|
132
138
|
f.dateFormat = "HH:mm:ss"
|
|
133
139
|
return f.string(from: Date())
|
|
134
140
|
}()
|
|
135
|
-
raw = raw.replacingOccurrences(of: "{{_lastSyncTime}}", with: syncTime)
|
|
136
141
|
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
142
|
+
var allVars: [String: String] = [:]
|
|
143
|
+
let boundJson = Self.readSharedString(forKey: "widget_bound_data_\(widgetKey)", appGroup: appGroup)
|
|
144
|
+
?? (widgetKey != "main" ? Self.readSharedString(forKey: "widget_bound_data_main", appGroup: appGroup) : nil)
|
|
145
|
+
if let boundJson = boundJson,
|
|
146
|
+
let boundData = boundJson.data(using: .utf8),
|
|
147
|
+
let jsonObj = try? JSONSerialization.jsonObject(with: boundData) {
|
|
148
|
+
DynamicWidgetStateStore.flattenJsonObject(jsonObj, prefix: "", into: &allVars)
|
|
149
|
+
}
|
|
150
|
+
if let remoteVars = state.remoteVariables {
|
|
151
|
+
for (k, v) in remoteVars {
|
|
152
|
+
allVars[k] = v
|
|
141
153
|
}
|
|
142
154
|
}
|
|
143
|
-
|
|
155
|
+
allVars["_lastSyncTime"] = syncTime
|
|
156
|
+
allVars["_syncStatus"] = state.syncStatus ?? allVars["_syncStatus"] ?? "ok"
|
|
157
|
+
allVars["_syncError"] = state.lastSyncError ?? allVars["_syncError"] ?? ""
|
|
158
|
+
if let httpStatus = state.lastHttpStatus {
|
|
159
|
+
allVars["_httpStatus"] = "\(httpStatus)"
|
|
160
|
+
}
|
|
144
161
|
if let selectedConfig = Self.readSharedString(forKey: "widget_selected_config_\(widgetKey)", appGroup: appGroup) {
|
|
145
|
-
|
|
146
|
-
|
|
162
|
+
allVars["_selectedConfigId"] = selectedConfig
|
|
163
|
+
allVars["selectedConfigId"] = selectedConfig
|
|
164
|
+
}
|
|
165
|
+
let storedCounter = Self.readSharedString(forKey: "widget_counter_value", appGroup: appGroup)?
|
|
166
|
+
.trimmingCharacters(in: .whitespacesAndNewlines)
|
|
167
|
+
let counterVal: String? = (storedCounter?.isEmpty == false ? storedCounter : nil) ?? allVars["counter"]
|
|
168
|
+
if let counterVal = counterVal {
|
|
169
|
+
allVars["counter"] = counterVal
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
var raw: String?
|
|
173
|
+
if state.syncStatus == "error",
|
|
174
|
+
let errNode = readRemoteConfig()?.errorFallback,
|
|
175
|
+
let errData = try? JSONEncoder().encode(["root": errNode]),
|
|
176
|
+
let errJson = String(data: errData, encoding: .utf8) {
|
|
177
|
+
raw = errJson
|
|
178
|
+
} else {
|
|
179
|
+
let key = "widget_layout_\(widgetKey)"
|
|
180
|
+
raw = Self.readSharedString(forKey: key, appGroup: appGroup)
|
|
181
|
+
if raw == nil && widgetKey != "main" {
|
|
182
|
+
raw = Self.readSharedString(forKey: "widget_layout_main", appGroup: appGroup)
|
|
183
|
+
}
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
guard let rawLayout = raw else {
|
|
187
|
+
return nil
|
|
147
188
|
}
|
|
148
|
-
|
|
189
|
+
var resolved = DynamicWidgetStateStore.resolveTemplateString(rawLayout, with: allVars, escapeForJson: true)
|
|
190
|
+
if let counterVal = counterVal {
|
|
191
|
+
resolved = DynamicWidgetStateStore.applyCounterReplacement(in: resolved, counterValue: counterVal)
|
|
192
|
+
}
|
|
193
|
+
return resolved
|
|
149
194
|
}
|
|
150
195
|
|
|
151
196
|
public static func readSharedString(forKey key: String, appGroup: String) -> String? {
|
|
@@ -213,12 +258,17 @@ public struct DynamicWidgetProvider: TimelineProvider {
|
|
|
213
258
|
public struct DynamicHomeScreenWidgetView: View {
|
|
214
259
|
@Environment(\.widgetFamily) var family
|
|
215
260
|
@Environment(\.colorScheme) var colorScheme
|
|
261
|
+
@Environment(\.showsWidgetContainerBackground) var showsWidgetBackground
|
|
216
262
|
let entry: DynamicWidgetEntry
|
|
217
263
|
|
|
218
264
|
public init(entry: DynamicWidgetEntry) {
|
|
219
265
|
self.entry = entry
|
|
220
266
|
}
|
|
221
267
|
|
|
268
|
+
private var isStandByMode: Bool {
|
|
269
|
+
return family == .systemSmall && !showsWidgetBackground
|
|
270
|
+
}
|
|
271
|
+
|
|
222
272
|
private var parsedPayload: WidgetMultiPagePayloadDTO? {
|
|
223
273
|
guard let json = entry.layoutJson,
|
|
224
274
|
let data = json.data(using: .utf8),
|
|
@@ -241,6 +291,11 @@ public struct DynamicHomeScreenWidgetView: View {
|
|
|
241
291
|
return nil
|
|
242
292
|
}
|
|
243
293
|
|
|
294
|
+
// Hỗ trợ trực tiếp UI Intermediate Representation (IR v2.0)
|
|
295
|
+
if let root = payload.root {
|
|
296
|
+
return root
|
|
297
|
+
}
|
|
298
|
+
|
|
244
299
|
if let pages = payload.pages, !pages.isEmpty {
|
|
245
300
|
let state = DynamicWidgetStateStore.loadState()
|
|
246
301
|
let defaultOrder = payload.pageOrder ?? Array(pages.keys).sorted()
|
|
@@ -259,6 +314,8 @@ public struct DynamicHomeScreenWidgetView: View {
|
|
|
259
314
|
small: pageConfig.small ?? payload.small,
|
|
260
315
|
medium: pageConfig.medium ?? payload.medium,
|
|
261
316
|
large: pageConfig.large ?? payload.large,
|
|
317
|
+
extraLarge: pageConfig.extraLarge ?? payload.extraLarge,
|
|
318
|
+
standBy: pageConfig.standBy ?? payload.standBy,
|
|
262
319
|
accessoryRectangular: pageConfig.accessoryRectangular ?? payload.accessoryRectangular,
|
|
263
320
|
accessoryCircular: pageConfig.accessoryCircular ?? payload.accessoryCircular,
|
|
264
321
|
accessoryInline: pageConfig.accessoryInline ?? payload.accessoryInline
|
|
@@ -270,6 +327,8 @@ public struct DynamicHomeScreenWidgetView: View {
|
|
|
270
327
|
small: payload.small,
|
|
271
328
|
medium: payload.medium,
|
|
272
329
|
large: payload.large,
|
|
330
|
+
extraLarge: payload.extraLarge,
|
|
331
|
+
standBy: payload.standBy,
|
|
273
332
|
accessoryRectangular: payload.accessoryRectangular,
|
|
274
333
|
accessoryCircular: payload.accessoryCircular,
|
|
275
334
|
accessoryInline: payload.accessoryInline
|
|
@@ -280,6 +339,8 @@ public struct DynamicHomeScreenWidgetView: View {
|
|
|
280
339
|
small: LayoutNodeDTO?,
|
|
281
340
|
medium: LayoutNodeDTO?,
|
|
282
341
|
large: LayoutNodeDTO?,
|
|
342
|
+
extraLarge: LayoutNodeDTO? = nil,
|
|
343
|
+
standBy: LayoutNodeDTO? = nil,
|
|
283
344
|
accessoryRectangular: LayoutNodeDTO? = nil,
|
|
284
345
|
accessoryCircular: LayoutNodeDTO? = nil,
|
|
285
346
|
accessoryInline: LayoutNodeDTO? = nil
|
|
@@ -297,13 +358,19 @@ public struct DynamicHomeScreenWidgetView: View {
|
|
|
297
358
|
}
|
|
298
359
|
}
|
|
299
360
|
|
|
361
|
+
if isStandByMode, let standByNode = standBy {
|
|
362
|
+
return standByNode
|
|
363
|
+
}
|
|
364
|
+
|
|
300
365
|
switch family {
|
|
301
366
|
case .systemSmall:
|
|
302
367
|
return small ?? medium ?? large
|
|
303
368
|
case .systemMedium:
|
|
304
369
|
return medium ?? small ?? large
|
|
305
|
-
case .systemLarge
|
|
370
|
+
case .systemLarge:
|
|
306
371
|
return large ?? medium ?? small
|
|
372
|
+
case .systemExtraLarge:
|
|
373
|
+
return extraLarge ?? large ?? medium ?? small
|
|
307
374
|
default:
|
|
308
375
|
return small ?? medium ?? large
|
|
309
376
|
}
|
|
@@ -432,3 +499,14 @@ extension View {
|
|
|
432
499
|
}
|
|
433
500
|
}
|
|
434
501
|
}
|
|
502
|
+
|
|
503
|
+
extension WidgetConfiguration {
|
|
504
|
+
/// Tùy chọn tắt lề mặc định để hỗ trợ chế độ StandBy / Full-Bleed Widget trên iOS 17+
|
|
505
|
+
public func applyStandByMargins() -> some WidgetConfiguration {
|
|
506
|
+
if #available(iOS 15.0, *) {
|
|
507
|
+
return self.contentMarginsDisabled()
|
|
508
|
+
} else {
|
|
509
|
+
return self
|
|
510
|
+
}
|
|
511
|
+
}
|
|
512
|
+
}
|
|
@@ -8,9 +8,9 @@ public struct DynamicLiveActivityWidget: Widget {
|
|
|
8
8
|
|
|
9
9
|
public var body: some WidgetConfiguration {
|
|
10
10
|
ActivityConfiguration(for: DynamicActivityAttributes.self) { context in
|
|
11
|
-
// Render Lock Screen
|
|
11
|
+
// Render Lock Screen (tự chuyển sang staleLockScreen nếu context.isStale)
|
|
12
12
|
let payload = parsePayload(json: context.state.payloadJson)
|
|
13
|
-
if let lockScreen = payload
|
|
13
|
+
if let lockScreen = effectiveLockScreenNode(context: context, payload: payload) {
|
|
14
14
|
DynamicNodeView(node: lockScreen)
|
|
15
15
|
.activityBackgroundTint(.black.opacity(0.8))
|
|
16
16
|
.activitySystemActionForegroundColor(.white)
|
|
@@ -19,7 +19,8 @@ public struct DynamicLiveActivityWidget: Widget {
|
|
|
19
19
|
}
|
|
20
20
|
} dynamicIsland: { context in
|
|
21
21
|
let payload = parsePayload(json: context.state.payloadJson)
|
|
22
|
-
let island = payload
|
|
22
|
+
let island = effectiveDynamicIsland(context: context, payload: payload)
|
|
23
|
+
let lockScreenFallback = effectiveLockScreenNode(context: context, payload: payload)
|
|
23
24
|
|
|
24
25
|
return DynamicIsland {
|
|
25
26
|
// Expanded Regions với Safe Padding & Smart Fallback tránh tình trạng Dynamic Island bị đen trống rỗng
|
|
@@ -38,7 +39,7 @@ public struct DynamicLiveActivityWidget: Widget {
|
|
|
38
39
|
}
|
|
39
40
|
}
|
|
40
41
|
DynamicIslandExpandedRegion(.bottom) {
|
|
41
|
-
if let bottom = island?.expanded?.bottom ??
|
|
42
|
+
if let bottom = island?.expanded?.bottom ?? lockScreenFallback {
|
|
42
43
|
DynamicNodeView(node: bottom)
|
|
43
44
|
.padding(.horizontal, 8)
|
|
44
45
|
.padding(.bottom, 6)
|
|
@@ -71,6 +72,26 @@ public struct DynamicLiveActivityWidget: Widget {
|
|
|
71
72
|
}
|
|
72
73
|
}
|
|
73
74
|
|
|
75
|
+
private func effectiveLockScreenNode(
|
|
76
|
+
context: ActivityViewContext<DynamicActivityAttributes>,
|
|
77
|
+
payload: DynamicPayloadDTO?
|
|
78
|
+
) -> LayoutNodeDTO? {
|
|
79
|
+
if #available(iOS 16.2, *), context.isStale, let staleNode = payload?.staleLockScreen {
|
|
80
|
+
return staleNode
|
|
81
|
+
}
|
|
82
|
+
return payload?.lockScreen
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
private func effectiveDynamicIsland(
|
|
86
|
+
context: ActivityViewContext<DynamicActivityAttributes>,
|
|
87
|
+
payload: DynamicPayloadDTO?
|
|
88
|
+
) -> DynamicIslandDTO? {
|
|
89
|
+
if #available(iOS 16.2, *), context.isStale, let staleIsland = payload?.staleDynamicIsland {
|
|
90
|
+
return staleIsland
|
|
91
|
+
}
|
|
92
|
+
return payload?.dynamicIsland
|
|
93
|
+
}
|
|
94
|
+
|
|
74
95
|
private func parsePayload(json: String) -> DynamicPayloadDTO? {
|
|
75
96
|
guard let data = json.data(using: .utf8) else { return nil }
|
|
76
97
|
return try? JSONDecoder().decode(DynamicPayloadDTO.self, from: data)
|
package/lib/builder.d.ts
CHANGED
|
@@ -1,4 +1,25 @@
|
|
|
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';
|
|
1
|
+
import { BadgeNode, ButtonNode, ChartNode, ContainerProps, ControlWidgetConfig, CustomNode, DataBindingField, DataBindingProxy, DividerNode, EqualizerNode, EqualizerProps, GaugeNode, GridNode, GridProps, HStackNode, ImageNode, LayoutNode, LinkNode, LinkProps, ProgressNode, SpacerNode, StyleProp, TextNode, TextStyle, TimerNode, ToggleNode, VStackNode, WidgetDataPipeOptions, ZStackNode, ZStackProps } from './types';
|
|
2
|
+
export declare function isDataBinding(value: any): value is DataBindingField<any>;
|
|
3
|
+
export declare function resolveBindingValue(value: any): any;
|
|
4
|
+
/**
|
|
5
|
+
* Tạo đối tượng Data Binding có cấu trúc & gợi ý kiểu TypeScript để nhúng trực tiếp vào JSX/DSL Widget.
|
|
6
|
+
*/
|
|
7
|
+
export declare function createDataBinding<T extends Record<string, any> = Record<string, any>>(options?: {
|
|
8
|
+
defaults?: Record<string, any>;
|
|
9
|
+
prefix?: string;
|
|
10
|
+
}): DataBindingProxy<T>;
|
|
11
|
+
/**
|
|
12
|
+
* Làm phẳng đệ quy JSON lồng nhau thành các đường dẫn dot-notation (`user.name`, `items.0.title`).
|
|
13
|
+
*/
|
|
14
|
+
export declare function flattenDataObject(obj: any, prefix?: string, out?: Record<string, string>): Record<string, string>;
|
|
15
|
+
/**
|
|
16
|
+
* Thực thi các phép biến đổi Pipe trên chuỗi giá trị thô (đồng bộ 1:1 với Swift & Kotlin).
|
|
17
|
+
*/
|
|
18
|
+
export declare function evaluateTemplatePipe(rawValue: string | undefined, pipes: string[]): string;
|
|
19
|
+
/**
|
|
20
|
+
* Thay thế toàn bộ token `{{path|pipe1|pipe2}}` trong chuỗi theo bản đồ biến (hỗ trợ cả JSON lồng nhau).
|
|
21
|
+
*/
|
|
22
|
+
export declare function resolveTemplateString(template: string, vars: Record<string, any>): string;
|
|
2
23
|
export declare function flattenStyle<T extends object>(...styles: StyleProp<T>[]): T | undefined;
|
|
3
24
|
export type AnyWidgetStyle = TextStyle | ContainerProps | Record<string, any>;
|
|
4
25
|
export type NamedStyles<T> = {
|
|
@@ -18,7 +39,7 @@ export declare const UI: {
|
|
|
18
39
|
};
|
|
19
40
|
VStack: (propsOrChildren?: StyleProp<ContainerProps> | LayoutNode | LayoutNode[], ...children: LayoutNode[]) => VStackNode;
|
|
20
41
|
HStack: (propsOrChildren?: StyleProp<ContainerProps> | LayoutNode | LayoutNode[], ...children: LayoutNode[]) => HStackNode;
|
|
21
|
-
Text: (text: string
|
|
42
|
+
Text: (text: string | DataBindingField<any>, ...styles: StyleProp<TextStyle>[]) => TextNode;
|
|
22
43
|
Timer: (targetTimestamp: number, options?: {
|
|
23
44
|
mode?: "countdown" | "countup";
|
|
24
45
|
color?: string;
|
|
@@ -27,10 +48,10 @@ export declare const UI: {
|
|
|
27
48
|
prefix?: string;
|
|
28
49
|
suffix?: string;
|
|
29
50
|
}) => 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;
|
|
51
|
+
Progress: (valueOrOptions: number | string | DataBindingField<any> | ProgressNode["props"], options?: Omit<ProgressNode["props"], "value">) => ProgressNode;
|
|
52
|
+
Image: (urlOrOptions: string | DataBindingField<any> | ImageNode["props"], options?: Omit<ImageNode["props"], "url">) => ImageNode;
|
|
32
53
|
Spacer: (minLength?: number) => SpacerNode;
|
|
33
|
-
Button: (titleOrProps: string | ButtonNode["props"], options?: Omit<ButtonNode["props"], "title">) => ButtonNode;
|
|
54
|
+
Button: (titleOrProps: string | DataBindingField<any> | ButtonNode["props"], options?: Omit<ButtonNode["props"], "title">) => ButtonNode;
|
|
34
55
|
/**
|
|
35
56
|
* Tạo nút bấm kèm logic hàm TypeScript trực tiếp.
|
|
36
57
|
* 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!
|
|
@@ -39,10 +60,10 @@ export declare const UI: {
|
|
|
39
60
|
ZStack: (propsOrChildren?: ZStackProps | LayoutNode | LayoutNode[], ...children: LayoutNode[]) => ZStackNode;
|
|
40
61
|
Grid: (propsOrChildren?: GridProps | LayoutNode | LayoutNode[], ...children: LayoutNode[]) => GridNode;
|
|
41
62
|
Divider: (options?: DividerNode["props"]) => DividerNode;
|
|
42
|
-
Gauge: (valueOrOptions: number | GaugeNode["props"], options?: Omit<GaugeNode["props"], "value">) => GaugeNode;
|
|
63
|
+
Gauge: (valueOrOptions: number | string | DataBindingField<any> | GaugeNode["props"], options?: Omit<GaugeNode["props"], "value">) => GaugeNode;
|
|
43
64
|
Chart: (valuesOrOptions: number[] | ChartNode["props"], options?: Omit<ChartNode["props"], "values">) => ChartNode;
|
|
44
65
|
Toggle: (labelOrOptions: string | ToggleNode["props"], options?: Omit<ToggleNode["props"], "label">) => ToggleNode;
|
|
45
|
-
Badge: (textOrOptions: string | BadgeNode["props"], options?: Omit<BadgeNode["props"], "text">) => BadgeNode;
|
|
66
|
+
Badge: (textOrOptions: string | DataBindingField<any> | BadgeNode["props"], options?: Omit<BadgeNode["props"], "text">) => BadgeNode;
|
|
46
67
|
Link: (props: LinkProps, ...children: LayoutNode[]) => LinkNode;
|
|
47
68
|
/**
|
|
48
69
|
* Khởi tạo một Component Native tùy chỉnh đã được đăng ký qua:
|
|
@@ -56,5 +77,27 @@ export declare const UI: {
|
|
|
56
77
|
* và hiển thị trực quan trên Android.
|
|
57
78
|
*/
|
|
58
79
|
Equalizer: (options?: EqualizerProps) => EqualizerNode;
|
|
80
|
+
/**
|
|
81
|
+
* Cấu hình Control Button cho iOS 18+ Control Center / Action Button & Android Quick Settings Tile.
|
|
82
|
+
*/
|
|
83
|
+
ControlButton: (options: Omit<ControlWidgetConfig, "type" | "actionId"> & {
|
|
84
|
+
actionId?: string;
|
|
85
|
+
onPress?: (payload?: any) => Promise<any> | any;
|
|
86
|
+
}) => ControlWidgetConfig;
|
|
87
|
+
/**
|
|
88
|
+
* Cấu hình Control Toggle 2 trạng thái cho iOS 18+ Control Center & Android Quick Settings Tile.
|
|
89
|
+
*/
|
|
90
|
+
ControlToggle: (options: Omit<ControlWidgetConfig, "type" | "actionId"> & {
|
|
91
|
+
actionId?: string;
|
|
92
|
+
onPress?: (payload?: any) => Promise<any> | any;
|
|
93
|
+
}) => ControlWidgetConfig;
|
|
94
|
+
/**
|
|
95
|
+
* Tạo biểu thức Data Binding chuỗi token (`{{path|pipe1|pipe2}}`) dùng với Background Data Engine 2.0.
|
|
96
|
+
*/
|
|
97
|
+
bind: (path: string, pipes?: WidgetDataPipeOptions) => string;
|
|
98
|
+
/**
|
|
99
|
+
* Tạo Proxy Data Binding có cấu trúc & gợi ý kiểu TypeScript (`data.user.name`, `data.attendance.progress.divide(100)`).
|
|
100
|
+
*/
|
|
101
|
+
createDataBinding: typeof createDataBinding;
|
|
59
102
|
};
|
|
60
103
|
//# sourceMappingURL=builder.d.ts.map
|
package/lib/builder.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,UAAU,EACV,SAAS,EACT,cAAc,EACd,UAAU,EACV,WAAW,EACX,aAAa,EACb,cAAc,EACd,SAAS,EACT,QAAQ,EACR,SAAS,EACT,UAAU,EACV,SAAS,EACT,UAAU,EACV,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,UAAU,EACV,SAAS,EACT,QAAQ,
|
|
1
|
+
{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"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"}
|