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.
- package/CHANGELOG.md +37 -0
- package/README.md +89 -49
- 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 +86 -13
- package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetImageCache.kt +53 -0
- package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetStateStore.kt +647 -104
- package/android/src/main/java/com/reactnativeliveactivity/widgets/DynamicHomeScreenWidgetProvider.kt +3 -1
- package/android/src/main/java/com/reactnativeliveactivity/widgets/DynamicQuickSettingsTileService.kt +120 -0
- package/app.plugin.js +36 -0
- package/assets/MaterialIcons.json +2236 -0
- package/cli/codegen.js +889 -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 +203 -21
- package/docs/GUIDE-VI.md +207 -22
- package/docs/index.html +1461 -226
- package/docs/llms-full.txt +15 -0
- package/docs/llms.txt +16 -7
- package/ios/Bridge/LiveActivityModule.swift +333 -44
- package/ios/Intents/DynamicWidgetActionIntent.swift +57 -2
- package/ios/Models/DynamicLayoutModels.swift +114 -4
- package/ios/Renderer/DynamicNodeView.swift +15 -6
- package/ios/Storage/DynamicWidgetStateStore.swift +649 -38
- package/ios/Widgets/DynamicControlWidget.swift +63 -0
- package/ios/Widgets/DynamicHomeScreenWidget.swift +99 -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 +326 -18
- package/lib/builder.js.map +1 -1
- package/lib/hooks.d.ts +13 -9
- package/lib/hooks.d.ts.map +1 -1
- package/lib/hooks.js +70 -12
- package/lib/hooks.js.map +1 -1
- package/lib/index.d.ts +80 -7
- package/lib/index.d.ts.map +1 -1
- package/lib/index.js +303 -59
- package/lib/index.js.map +1 -1
- package/lib/ir.d.ts.map +1 -1
- package/lib/ir.js +9 -2
- package/lib/ir.js.map +1 -1
- package/lib/jsx.d.ts +11 -7
- package/lib/jsx.d.ts.map +1 -1
- package/lib/jsx.js +50 -13
- 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 -4
- package/lib/preview.d.ts.map +1 -1
- package/lib/preview.js +150 -82
- 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 +302 -18
- package/lib/types.d.ts.map +1 -1
- package/package.json +6 -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 +382 -24
- package/src/hooks.ts +88 -12
- package/src/index.ts +319 -56
- package/src/ir.ts +8 -2
- package/src/jsx.tsx +69 -21
- package/src/material-icons.generated.ts +3844 -0
- package/src/preview.tsx +235 -81
- package/src/sf-symbols.generated.ts +9533 -0
- package/src/types.ts +348 -18
|
@@ -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),
|
|
@@ -264,6 +314,8 @@ public struct DynamicHomeScreenWidgetView: View {
|
|
|
264
314
|
small: pageConfig.small ?? payload.small,
|
|
265
315
|
medium: pageConfig.medium ?? payload.medium,
|
|
266
316
|
large: pageConfig.large ?? payload.large,
|
|
317
|
+
extraLarge: pageConfig.extraLarge ?? payload.extraLarge,
|
|
318
|
+
standBy: pageConfig.standBy ?? payload.standBy,
|
|
267
319
|
accessoryRectangular: pageConfig.accessoryRectangular ?? payload.accessoryRectangular,
|
|
268
320
|
accessoryCircular: pageConfig.accessoryCircular ?? payload.accessoryCircular,
|
|
269
321
|
accessoryInline: pageConfig.accessoryInline ?? payload.accessoryInline
|
|
@@ -275,6 +327,8 @@ public struct DynamicHomeScreenWidgetView: View {
|
|
|
275
327
|
small: payload.small,
|
|
276
328
|
medium: payload.medium,
|
|
277
329
|
large: payload.large,
|
|
330
|
+
extraLarge: payload.extraLarge,
|
|
331
|
+
standBy: payload.standBy,
|
|
278
332
|
accessoryRectangular: payload.accessoryRectangular,
|
|
279
333
|
accessoryCircular: payload.accessoryCircular,
|
|
280
334
|
accessoryInline: payload.accessoryInline
|
|
@@ -285,6 +339,8 @@ public struct DynamicHomeScreenWidgetView: View {
|
|
|
285
339
|
small: LayoutNodeDTO?,
|
|
286
340
|
medium: LayoutNodeDTO?,
|
|
287
341
|
large: LayoutNodeDTO?,
|
|
342
|
+
extraLarge: LayoutNodeDTO? = nil,
|
|
343
|
+
standBy: LayoutNodeDTO? = nil,
|
|
288
344
|
accessoryRectangular: LayoutNodeDTO? = nil,
|
|
289
345
|
accessoryCircular: LayoutNodeDTO? = nil,
|
|
290
346
|
accessoryInline: LayoutNodeDTO? = nil
|
|
@@ -302,13 +358,19 @@ public struct DynamicHomeScreenWidgetView: View {
|
|
|
302
358
|
}
|
|
303
359
|
}
|
|
304
360
|
|
|
361
|
+
if isStandByMode, let standByNode = standBy {
|
|
362
|
+
return standByNode
|
|
363
|
+
}
|
|
364
|
+
|
|
305
365
|
switch family {
|
|
306
366
|
case .systemSmall:
|
|
307
367
|
return small ?? medium ?? large
|
|
308
368
|
case .systemMedium:
|
|
309
369
|
return medium ?? small ?? large
|
|
310
|
-
case .systemLarge
|
|
370
|
+
case .systemLarge:
|
|
311
371
|
return large ?? medium ?? small
|
|
372
|
+
case .systemExtraLarge:
|
|
373
|
+
return extraLarge ?? large ?? medium ?? small
|
|
312
374
|
default:
|
|
313
375
|
return small ?? medium ?? large
|
|
314
376
|
}
|
|
@@ -437,3 +499,14 @@ extension View {
|
|
|
437
499
|
}
|
|
438
500
|
}
|
|
439
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,EAER,SAAS,EACT,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACZ,MAAM,SAAS,CAAC;AAKjB,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAiBvF;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE9E,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,GAAG,cAAc;CAC/B,CAAC;AAEF,eAAO,MAAM,UAAU;aACZ,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,KAAG,CAAC;;CAEvF,CAAC;
|
|
1
|
+
{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"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"}
|