react-native-live-widgets 1.2.1 → 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 (79) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/README.md +89 -49
  3. package/android/src/main/AndroidManifest.xml +12 -0
  4. package/android/src/main/assets/fonts/MaterialIcons-Regular.ttf +0 -0
  5. package/android/src/main/java/com/reactnativeliveactivity/bridge/LiveActivityModule.kt +61 -1
  6. package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityNotifier.kt +153 -17
  7. package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityReceiver.kt +1 -1
  8. package/android/src/main/java/com/reactnativeliveactivity/renderer/DynamicWidgetCanvasRenderer.kt +86 -13
  9. package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetImageCache.kt +53 -0
  10. package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetStateStore.kt +647 -104
  11. package/android/src/main/java/com/reactnativeliveactivity/widgets/DynamicHomeScreenWidgetProvider.kt +3 -1
  12. package/android/src/main/java/com/reactnativeliveactivity/widgets/DynamicQuickSettingsTileService.kt +120 -0
  13. package/app.plugin.js +36 -0
  14. package/assets/MaterialIcons.json +2236 -0
  15. package/cli/codegen.js +789 -0
  16. package/cli/setup.js +323 -63
  17. package/docs/EXPO-GUIDE-EN.md +21 -3
  18. package/docs/EXPO-GUIDE-VI.md +21 -3
  19. package/docs/GUIDE-EN.md +203 -21
  20. package/docs/GUIDE-VI.md +207 -22
  21. package/docs/index.html +1328 -211
  22. package/docs/llms-full.txt +15 -0
  23. package/docs/llms.txt +16 -7
  24. package/ios/Bridge/LiveActivityModule.swift +333 -44
  25. package/ios/Intents/DynamicWidgetActionIntent.swift +57 -2
  26. package/ios/Models/DynamicLayoutModels.swift +114 -4
  27. package/ios/Renderer/DynamicNodeView.swift +15 -6
  28. package/ios/Storage/DynamicWidgetStateStore.swift +649 -38
  29. package/ios/Widgets/DynamicControlWidget.swift +63 -0
  30. package/ios/Widgets/DynamicHomeScreenWidget.swift +99 -26
  31. package/ios/Widgets/DynamicLiveActivityWidget.swift +25 -4
  32. package/lib/builder.d.ts +50 -7
  33. package/lib/builder.d.ts.map +1 -1
  34. package/lib/builder.js +326 -18
  35. package/lib/builder.js.map +1 -1
  36. package/lib/hooks.d.ts +13 -9
  37. package/lib/hooks.d.ts.map +1 -1
  38. package/lib/hooks.js +70 -12
  39. package/lib/hooks.js.map +1 -1
  40. package/lib/index.d.ts +80 -7
  41. package/lib/index.d.ts.map +1 -1
  42. package/lib/index.js +303 -59
  43. package/lib/index.js.map +1 -1
  44. package/lib/ir.d.ts.map +1 -1
  45. package/lib/ir.js +9 -2
  46. package/lib/ir.js.map +1 -1
  47. package/lib/jsx.d.ts +11 -7
  48. package/lib/jsx.d.ts.map +1 -1
  49. package/lib/jsx.js +50 -13
  50. package/lib/jsx.js.map +1 -1
  51. package/lib/material-icons.generated.d.ts +8 -0
  52. package/lib/material-icons.generated.d.ts.map +1 -0
  53. package/lib/material-icons.generated.js +9 -0
  54. package/lib/material-icons.generated.js.map +1 -0
  55. package/lib/preview.d.ts +11 -4
  56. package/lib/preview.d.ts.map +1 -1
  57. package/lib/preview.js +150 -82
  58. package/lib/preview.js.map +1 -1
  59. package/lib/sf-symbols.generated.d.ts +8 -0
  60. package/lib/sf-symbols.generated.d.ts.map +1 -0
  61. package/lib/sf-symbols.generated.js +9 -0
  62. package/lib/sf-symbols.generated.js.map +1 -0
  63. package/lib/types.d.ts +302 -18
  64. package/lib/types.d.ts.map +1 -1
  65. package/package.json +6 -2
  66. package/scripts/build.js +98 -0
  67. package/scripts/generate-material-icons.js +93 -0
  68. package/scripts/generate-sf-symbols.js +95 -0
  69. package/scripts/release.js +115 -0
  70. package/scripts/test-ir-semantic.js +314 -0
  71. package/src/builder.ts +382 -24
  72. package/src/hooks.ts +88 -12
  73. package/src/index.ts +319 -56
  74. package/src/ir.ts +8 -2
  75. package/src/jsx.tsx +69 -21
  76. package/src/material-icons.generated.ts +3844 -0
  77. package/src/preview.tsx +235 -81
  78. package/src/sf-symbols.generated.ts +9533 -0
  79. package/src/types.ts +348 -18
@@ -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),
@@ -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, .systemExtraLarge:
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?.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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"}