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.
Files changed (87) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/README.md +129 -50
  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 +529 -59
  9. package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetImageCache.kt +53 -0
  10. package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetStateStore.kt +684 -83
  11. package/android/src/main/java/com/reactnativeliveactivity/widgets/DynamicHomeScreenWidgetProvider.kt +129 -57
  12. package/android/src/main/java/com/reactnativeliveactivity/widgets/DynamicQuickSettingsTileService.kt +120 -0
  13. package/android/src/main/res/layout/rn_live_widget_hit_zone.xml +16 -0
  14. package/android/src/main/res/layout/rn_live_widget_host.xml +16 -87
  15. package/app.plugin.js +36 -0
  16. package/assets/MaterialIcons.json +2236 -0
  17. package/cli/codegen.js +789 -0
  18. package/cli/setup.js +323 -63
  19. package/docs/EXPO-GUIDE-EN.md +21 -3
  20. package/docs/EXPO-GUIDE-VI.md +21 -3
  21. package/docs/GUIDE-EN.md +444 -21
  22. package/docs/GUIDE-VI.md +473 -22
  23. package/docs/index.html +2263 -265
  24. package/docs/llms-full.txt +41 -0
  25. package/docs/llms.txt +24 -7
  26. package/ios/Bridge/LiveActivityModule.swift +333 -44
  27. package/ios/Intents/DynamicWidgetActionIntent.swift +57 -2
  28. package/ios/Models/DynamicLayoutModels.swift +120 -5
  29. package/ios/Renderer/DynamicNodeView.swift +184 -20
  30. package/ios/Storage/DynamicWidgetStateStore.swift +649 -38
  31. package/ios/Widgets/DynamicControlWidget.swift +63 -0
  32. package/ios/Widgets/DynamicHomeScreenWidget.swift +104 -26
  33. package/ios/Widgets/DynamicLiveActivityWidget.swift +25 -4
  34. package/lib/builder.d.ts +50 -7
  35. package/lib/builder.d.ts.map +1 -1
  36. package/lib/builder.js +391 -29
  37. package/lib/builder.js.map +1 -1
  38. package/lib/dispatcher.js +16 -10
  39. package/lib/dispatcher.js.map +1 -1
  40. package/lib/hooks.d.ts +13 -9
  41. package/lib/hooks.d.ts.map +1 -1
  42. package/lib/hooks.js +105 -42
  43. package/lib/hooks.js.map +1 -1
  44. package/lib/index.d.ts +96 -8
  45. package/lib/index.d.ts.map +1 -1
  46. package/lib/index.js +415 -97
  47. package/lib/index.js.map +1 -1
  48. package/lib/ir.d.ts +15 -0
  49. package/lib/ir.d.ts.map +1 -0
  50. package/lib/ir.js +386 -0
  51. package/lib/ir.js.map +1 -0
  52. package/lib/jsx.d.ts +19 -7
  53. package/lib/jsx.d.ts.map +1 -1
  54. package/lib/jsx.js +179 -95
  55. package/lib/jsx.js.map +1 -1
  56. package/lib/material-icons.generated.d.ts +8 -0
  57. package/lib/material-icons.generated.d.ts.map +1 -0
  58. package/lib/material-icons.generated.js +9 -0
  59. package/lib/material-icons.generated.js.map +1 -0
  60. package/lib/preview.d.ts +11 -27
  61. package/lib/preview.d.ts.map +1 -1
  62. package/lib/preview.js +456 -119
  63. package/lib/preview.js.map +1 -1
  64. package/lib/sf-symbols.generated.d.ts +8 -0
  65. package/lib/sf-symbols.generated.d.ts.map +1 -0
  66. package/lib/sf-symbols.generated.js +9 -0
  67. package/lib/sf-symbols.generated.js.map +1 -0
  68. package/lib/types.d.ts +506 -30
  69. package/lib/types.d.ts.map +1 -1
  70. package/lib/types.js +2 -1
  71. package/lib/types.js.map +1 -1
  72. package/package.json +7 -2
  73. package/scripts/build.js +98 -0
  74. package/scripts/generate-material-icons.js +93 -0
  75. package/scripts/generate-sf-symbols.js +95 -0
  76. package/scripts/release.js +115 -0
  77. package/scripts/test-ir-semantic.js +314 -0
  78. package/src/builder.ts +439 -26
  79. package/src/hooks.ts +88 -12
  80. package/src/index.ts +385 -57
  81. package/src/ir.ts +436 -0
  82. package/src/jsx.tsx +99 -21
  83. package/src/material-icons.generated.ts +3844 -0
  84. package/src/preview.tsx +533 -55
  85. package/src/react-native-env.d.ts +1 -0
  86. package/src/sf-symbols.generated.ts +9533 -0
  87. 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
- if let timelineRaw = Self.readSharedString(forKey: "widget_timeline_\(wKey)", appGroup: group),
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 - (state.updatedAt ?? 0)
86
- let needsRemoteSync = hasRemoteConfig && hasTemplateVars && (state.lastSyncTime == nil || secondsSinceLastUpdate >= 20)
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 readRefreshIntervalMinutes() -> Int {
111
+ private func readRemoteConfig() -> WidgetRemoteConfigDTO? {
110
112
  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) {
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 readLayoutJson() -> String? {
120
- let key = "widget_layout_\(widgetKey)"
121
- var raw: String? = Self.readSharedString(forKey: key, appGroup: appGroup)
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
- if let vars = state.remoteVariables {
138
- for (k, v) in vars {
139
- let escaped = v.replacingOccurrences(of: "\"", with: "\\\"")
140
- raw = raw.replacingOccurrences(of: "{{\(k)}}", with: escaped)
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
- raw = raw.replacingOccurrences(of: "{{_selectedConfigId}}", with: selectedConfig)
146
- raw = raw.replacingOccurrences(of: "{{selectedConfigId}}", with: selectedConfig)
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
- return raw
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, .systemExtraLarge:
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?.lockScreen {
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?.dynamicIsland
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 ?? payload?.lockScreen {
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, ...styles: StyleProp<TextStyle>[]) => TextNode;
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
@@ -1 +1 @@
1
- {"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"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"}