react-native-live-widgets 0.0.0-stage → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +13 -0
- package/LICENSE +21 -0
- package/README.md +221 -2
- package/android/build.gradle +49 -0
- package/android/src/main/AndroidManifest.xml +38 -0
- package/android/src/main/java/com/reactnativeliveactivity/bridge/LiveActivityModule.kt +440 -0
- package/android/src/main/java/com/reactnativeliveactivity/bridge/LiveActivityPackage.kt +17 -0
- package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityHeadlessTaskService.kt +24 -0
- package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityNotifier.kt +410 -0
- package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityReceiver.kt +67 -0
- package/android/src/main/java/com/reactnativeliveactivity/renderer/DynamicNodeRegistry.kt +64 -0
- package/android/src/main/java/com/reactnativeliveactivity/renderer/DynamicWidgetCanvasRenderer.kt +1223 -0
- package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetImageCache.kt +120 -0
- package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetStateStore.kt +281 -0
- package/android/src/main/java/com/reactnativeliveactivity/widgets/DynamicHomeScreenWidgetProvider.kt +229 -0
- package/android/src/main/res/layout/rn_live_widget_host.xml +113 -0
- package/android/src/main/res/xml/rn_live_widget_info.xml +14 -0
- package/assets/dashboard_features.png +0 -0
- package/assets/dynamic_island_expanded.png +0 -0
- package/assets/home_widget_interactive.png +0 -0
- package/assets/lock_screen_live_activity.png +0 -0
- package/cli/setup.js +94 -0
- package/docs/GUIDE-EN.md +804 -0
- package/docs/GUIDE-VI.md +802 -0
- package/docs/widgets.md +52 -0
- package/ios/Bridge/LiveActivityModule.m +105 -0
- package/ios/Bridge/LiveActivityModule.swift +957 -0
- package/ios/Intents/DynamicWidgetActionIntent.swift +38 -0
- package/ios/Models/DynamicActivityAttributes.swift +22 -0
- package/ios/Models/DynamicLayoutModels.swift +243 -0
- package/ios/Renderer/ColorHexExtension.swift +49 -0
- package/ios/Renderer/DynamicNodeRegistry.swift +54 -0
- package/ios/Renderer/DynamicNodeView.swift +1060 -0
- package/ios/Storage/DynamicWidgetImageCache.swift +137 -0
- package/ios/Storage/DynamicWidgetStateStore.swift +162 -0
- package/ios/Widgets/DynamicHomeScreenWidget.swift +435 -0
- package/ios/Widgets/DynamicLiveActivityWidget.swift +79 -0
- package/lib/builder.d.ts +60 -0
- package/lib/builder.d.ts.map +1 -0
- package/lib/builder.js +296 -0
- package/lib/builder.js.map +1 -0
- package/lib/dispatcher.d.ts +16 -0
- package/lib/dispatcher.d.ts.map +1 -0
- package/lib/dispatcher.js +23 -0
- package/lib/dispatcher.js.map +1 -0
- package/lib/index.d.ts +199 -0
- package/lib/index.d.ts.map +1 -0
- package/lib/index.js +634 -0
- package/lib/index.js.map +1 -0
- package/lib/types.d.ts +489 -0
- package/lib/types.d.ts.map +1 -0
- package/lib/types.js +10 -0
- package/lib/types.js.map +1 -0
- package/package.json +68 -4
- package/react-native-live-widgets.podspec +38 -0
- package/src/builder.ts +409 -0
- package/src/dispatcher.ts +25 -0
- package/src/index.ts +681 -0
- package/src/types.ts +595 -0
package/src/types.ts
ADDED
|
@@ -0,0 +1,595 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Schema cho cây giao diện linh hoạt (Declarative Layout Engine)
|
|
3
|
+
* Tầng JS truyền cây này sang Native để render trên:
|
|
4
|
+
* - Lock Screen & Dynamic Island (Live Activity)
|
|
5
|
+
* - Home Screen Widgets (Màn hình chính Small / Medium / Large)
|
|
6
|
+
* - Android Live Update & Ongoing Notification
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
export type LayoutNodeType =
|
|
10
|
+
| 'VStack'
|
|
11
|
+
| 'HStack'
|
|
12
|
+
| 'ZStack'
|
|
13
|
+
| 'Grid'
|
|
14
|
+
| 'Divider'
|
|
15
|
+
| 'Text'
|
|
16
|
+
| 'Timer'
|
|
17
|
+
| 'Progress'
|
|
18
|
+
| 'Gauge'
|
|
19
|
+
| 'Chart'
|
|
20
|
+
| 'Image'
|
|
21
|
+
| 'Spacer'
|
|
22
|
+
| 'Button'
|
|
23
|
+
| 'Toggle'
|
|
24
|
+
| 'Badge'
|
|
25
|
+
| 'Link'
|
|
26
|
+
| 'Equalizer'
|
|
27
|
+
| 'Custom';
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* Định dạng màu hỗ trợ chuỗi Hex đơn (ví dụ '#0F172A')
|
|
31
|
+
* hoặc Object Dynamic Color tự đổi theo chế độ Sáng / Tối (Dark Mode) của hệ điều hành.
|
|
32
|
+
*/
|
|
33
|
+
export type DynamicColor = string | { light: string; dark: string };
|
|
34
|
+
|
|
35
|
+
export interface BaseNode {
|
|
36
|
+
type: LayoutNodeType;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
export interface ContainerProps {
|
|
40
|
+
padding?: number;
|
|
41
|
+
paddingHorizontal?: number;
|
|
42
|
+
paddingVertical?: number;
|
|
43
|
+
spacing?: number;
|
|
44
|
+
backgroundColor?: DynamicColor;
|
|
45
|
+
borderRadius?: number;
|
|
46
|
+
borderColor?: DynamicColor;
|
|
47
|
+
borderWidth?: number;
|
|
48
|
+
alignment?: 'leading' | 'center' | 'trailing' | string;
|
|
49
|
+
justifyContent?: 'flexStart' | 'center' | 'flexEnd' | 'spaceBetween' | string;
|
|
50
|
+
/** Tự động ẩn hoặc làm mờ nội dung khi thiết bị đang khóa màn hình (Bảo mật chuẩn Apple) */
|
|
51
|
+
privacySensitive?: boolean;
|
|
52
|
+
/** Chủ động che nội dung thành vệt khối mờ Placeholder (Skeleton Redaction) */
|
|
53
|
+
redacted?: boolean;
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
export type FontWeight =
|
|
57
|
+
| 'regular'
|
|
58
|
+
| 'medium'
|
|
59
|
+
| 'semibold'
|
|
60
|
+
| 'bold'
|
|
61
|
+
| 'heavy'
|
|
62
|
+
| 'light'
|
|
63
|
+
| (string & {})
|
|
64
|
+
| string;
|
|
65
|
+
|
|
66
|
+
export interface TextStyle {
|
|
67
|
+
color?: DynamicColor;
|
|
68
|
+
fontSize?: number;
|
|
69
|
+
fontWeight?: FontWeight;
|
|
70
|
+
numberOfLines?: number;
|
|
71
|
+
strikethroughWhenToggled?: string;
|
|
72
|
+
/** Tự động làm mờ hoặc ẩn chữ khi màn hình khóa (iOS Privacy Redacted) */
|
|
73
|
+
privacySensitive?: boolean;
|
|
74
|
+
/** Chủ động che nội dung thành vệt khối mờ Placeholder (Skeleton Redaction) */
|
|
75
|
+
redacted?: boolean;
|
|
76
|
+
/** Hiệu ứng cuộn lật số mượt mà kiểu Odometer (iOS 16+ numericText animation) khi số liệu thay đổi */
|
|
77
|
+
numericAnimation?: boolean;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
export type StyleProp<T> = T | null | undefined | false | StyleProp<T>[];
|
|
81
|
+
|
|
82
|
+
export interface TextNodeProps extends TextStyle {
|
|
83
|
+
text: string;
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
export interface VStackNode extends BaseNode {
|
|
87
|
+
type: 'VStack';
|
|
88
|
+
props?: ContainerProps;
|
|
89
|
+
children: LayoutNode[];
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
export interface HStackNode extends BaseNode {
|
|
93
|
+
type: 'HStack';
|
|
94
|
+
props?: ContainerProps;
|
|
95
|
+
children: LayoutNode[];
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
export interface TextNode extends BaseNode {
|
|
99
|
+
type: 'Text';
|
|
100
|
+
props: TextNodeProps;
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
export interface TimerNode extends BaseNode {
|
|
104
|
+
type: 'Timer';
|
|
105
|
+
props: {
|
|
106
|
+
/** Epoch timestamp tính bằng giây để đếm tới (hoặc đếm từ) */
|
|
107
|
+
targetTimestamp: number;
|
|
108
|
+
/** 'countdown': đếm ngược tới mốc; 'countup': đếm tiến từ mốc */
|
|
109
|
+
mode?: 'countdown' | 'countup';
|
|
110
|
+
color?: DynamicColor;
|
|
111
|
+
fontSize?: number;
|
|
112
|
+
fontWeight?: 'regular' | 'medium' | 'semibold' | 'bold';
|
|
113
|
+
prefix?: string;
|
|
114
|
+
suffix?: string;
|
|
115
|
+
};
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
export interface ProgressNode extends BaseNode {
|
|
119
|
+
type: 'Progress';
|
|
120
|
+
props: {
|
|
121
|
+
// ── 1. Nguồn dữ liệu tiến trình ─────────────────────────────
|
|
122
|
+
/** Mốc bắt đầu (epoch giây) nếu dùng timer interval tự chạy */
|
|
123
|
+
startTimestamp?: number;
|
|
124
|
+
/** Mốc kết thúc (epoch giây) */
|
|
125
|
+
targetTimestamp?: number;
|
|
126
|
+
/** Giá trị cố định từ 0.0 đến 1.0 (nếu không dùng timer) */
|
|
127
|
+
value?: number;
|
|
128
|
+
|
|
129
|
+
// ── 2. Kiểu dáng hiển thị (Style & Shape) ───────────────────
|
|
130
|
+
/** 'bar': thanh liền mạch | 'segmented': thanh nhiều chặng | 'circular': vòng tròn % */
|
|
131
|
+
style?: 'bar' | 'segmented' | 'circular';
|
|
132
|
+
/** true: thanh rút ngắn dần về 0 (như đếm ngược OTP/Flash sale) | false: thanh đầy dần lên 100% */
|
|
133
|
+
countsDown?: boolean;
|
|
134
|
+
/** Chiều cao / độ dày thanh (pixel). Mặc định 6 */
|
|
135
|
+
height?: number;
|
|
136
|
+
/** Bo góc thanh. Mặc định bo tròn hoàn toàn */
|
|
137
|
+
borderRadius?: number;
|
|
138
|
+
|
|
139
|
+
// ── 3. Màu sắc & Gradient ───────────────────────────────────
|
|
140
|
+
/** Màu thanh khi lấp đầy (dạng '#RRGGBB' hoặc { light, dark }) */
|
|
141
|
+
tintColor?: DynamicColor;
|
|
142
|
+
/** Màu nền rãnh phía sau */
|
|
143
|
+
trackColor?: DynamicColor;
|
|
144
|
+
/** Dải màu Gradient lấp đầy (ví dụ ['#00C6FF', '#0072FF']) */
|
|
145
|
+
gradientColors?: string[];
|
|
146
|
+
|
|
147
|
+
// ── 4. Cảnh báo đổi màu thông minh (Smart Warning) ──────────
|
|
148
|
+
/** Số giây cuối trước khi hết hạn để tự đổi sang màu cảnh báo (vd 300 = còn 5 phút) */
|
|
149
|
+
warningSeconds?: number;
|
|
150
|
+
/** Màu cảnh báo khi bước vào giai đoạn warningSeconds (mặc định '#FFA500' cam hoặc đỏ) */
|
|
151
|
+
warningTintColor?: DynamicColor;
|
|
152
|
+
|
|
153
|
+
// ── 5. Thanh nhiều chặng (Segmented Progress) ───────────────
|
|
154
|
+
/** Tổng số chặng (ví dụ 4 bước: Đặt -> Nhận -> Nấu -> Giao) */
|
|
155
|
+
segments?: number;
|
|
156
|
+
/** Chặng hiện tại đang ở (từ 1 đến segments) */
|
|
157
|
+
currentSegment?: number;
|
|
158
|
+
/** Khoảng cách giữa các chặng (pixel) */
|
|
159
|
+
segmentSpacing?: number;
|
|
160
|
+
|
|
161
|
+
// ── 6. Tracker Icon (Vật di chuyển trên thanh) ───────────────
|
|
162
|
+
/** Icon SF Symbol chạy ở đầu thanh tiến trình (ví dụ 'car.fill', 'figure.walk') */
|
|
163
|
+
trackerSystemName?: string;
|
|
164
|
+
/** Tên asset ảnh chạy ở đầu thanh tiến trình (ví dụ 'fasty_mascot') */
|
|
165
|
+
trackerAssetName?: string;
|
|
166
|
+
/** Kích thước của tracker icon (pixel). Mặc định 16 */
|
|
167
|
+
trackerSize?: number;
|
|
168
|
+
|
|
169
|
+
// ── 7. Nhãn phần trăm ───────────────────────────────────────
|
|
170
|
+
/** Có hiển thị chữ phần trăm ở góc không (ví dụ "75%") */
|
|
171
|
+
showPercentage?: boolean;
|
|
172
|
+
percentageColor?: DynamicColor;
|
|
173
|
+
};
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
export interface ImageNode extends BaseNode {
|
|
177
|
+
type: 'Image';
|
|
178
|
+
props: {
|
|
179
|
+
/** URL ảnh từ mạng (https://...) - Tự động tải, nén tối ưu RAM và cache vào App Group cho Widget & Live Activity */
|
|
180
|
+
url?: string;
|
|
181
|
+
/** Chuỗi ảnh Base64 (có thể kèm tiền tố data:image/png;base64,... hoặc chuỗi raw base64) */
|
|
182
|
+
base64?: string;
|
|
183
|
+
/** Tên ảnh trong Xcode Assets.xcassets hoặc Android drawable */
|
|
184
|
+
assetName?: string;
|
|
185
|
+
/** Tên icon hệ thống SF Symbols trên iOS (ví dụ 'person.crop.circle.fill', 'flame.fill', 'cart.fill') */
|
|
186
|
+
systemName?: string;
|
|
187
|
+
/** Đường dẫn file cục bộ trong máy */
|
|
188
|
+
filePath?: string;
|
|
189
|
+
/** Icon SF Symbol dự phòng khi ảnh mạng chưa tải xong hoặc lỗi */
|
|
190
|
+
fallbackSystemName?: string;
|
|
191
|
+
width?: number;
|
|
192
|
+
height?: number;
|
|
193
|
+
/** 'fill': phủ kín khung ảnh (crop) | 'fit': vừa khung ảnh */
|
|
194
|
+
contentMode?: 'fit' | 'fill';
|
|
195
|
+
tintColor?: DynamicColor;
|
|
196
|
+
backgroundColor?: DynamicColor;
|
|
197
|
+
padding?: number;
|
|
198
|
+
/** Bo góc ảnh (đặt bằng width / 2 để tạo ảnh Avatar tròn) */
|
|
199
|
+
borderRadius?: number;
|
|
200
|
+
/** Độ dày viền quanh ảnh (ví dụ viền Avatar) */
|
|
201
|
+
borderWidth?: number;
|
|
202
|
+
/** Màu viền quanh ảnh */
|
|
203
|
+
borderColor?: DynamicColor;
|
|
204
|
+
/** Hiệu ứng hoạt họa cho SF Symbol trên iOS 17+ (bounce, pulse, variableColor) */
|
|
205
|
+
symbolEffect?: 'bounce' | 'pulse' | 'variableColor' | 'scale';
|
|
206
|
+
/** Cho phép icon tự động đổi màu tương thích chế độ StandBy / Tinted của iOS 17+ / iOS 18 */
|
|
207
|
+
widgetAccentable?: boolean;
|
|
208
|
+
/** Tự động ẩn hoặc làm mờ ảnh khi màn hình khóa */
|
|
209
|
+
privacySensitive?: boolean;
|
|
210
|
+
};
|
|
211
|
+
}
|
|
212
|
+
|
|
213
|
+
export interface SpacerNode extends BaseNode {
|
|
214
|
+
type: 'Spacer';
|
|
215
|
+
props?: {
|
|
216
|
+
minLength?: number;
|
|
217
|
+
};
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
export interface ButtonNode extends BaseNode {
|
|
221
|
+
type: 'Button';
|
|
222
|
+
props: {
|
|
223
|
+
title: string;
|
|
224
|
+
/**
|
|
225
|
+
* Mã hành động chạy ngầm ngay trên Widget (iOS 17+ AppIntent, không mở App):
|
|
226
|
+
* - 'page:<pageId>': Chuyển sang trang/tab cụ thể (vd 'page:todo', 'page:okr')
|
|
227
|
+
* - 'page:next' | 'page:prev': Lật sang trang kế tiếp / trang trước
|
|
228
|
+
* - 'toggle:<itemKey>': Tick / bỏ tick hoàn thành 1 mục ngay trên mặt Widget
|
|
229
|
+
*/
|
|
230
|
+
actionId?: string;
|
|
231
|
+
/** Hàm xử lý logic TypeScript chạy khi người dùng bấm nút ngoài Widget */
|
|
232
|
+
onPress?: (payload?: any) => Promise<any> | any;
|
|
233
|
+
/** Mở App và điều hướng tới URL Deep Link cụ thể */
|
|
234
|
+
deepLink?: string;
|
|
235
|
+
backgroundColor?: DynamicColor;
|
|
236
|
+
textColor?: DynamicColor;
|
|
237
|
+
fontSize?: number;
|
|
238
|
+
fontWeight?: 'regular' | 'medium' | 'semibold' | 'bold';
|
|
239
|
+
padding?: number;
|
|
240
|
+
paddingHorizontal?: number;
|
|
241
|
+
paddingVertical?: number;
|
|
242
|
+
borderRadius?: number;
|
|
243
|
+
fullWidth?: boolean;
|
|
244
|
+
/** Tiêu đề hiển thị khi nút ở trạng thái đã tick (dùng với actionId 'toggle:<key>') */
|
|
245
|
+
checkedTitle?: string;
|
|
246
|
+
/** Màu nền khi nút đã được tick */
|
|
247
|
+
checkedBackgroundColor?: DynamicColor;
|
|
248
|
+
/** Màu chữ khi nút đã được tick */
|
|
249
|
+
checkedTextColor?: DynamicColor;
|
|
250
|
+
};
|
|
251
|
+
}
|
|
252
|
+
|
|
253
|
+
export interface ZStackProps extends ContainerProps {
|
|
254
|
+
zAlignment?:
|
|
255
|
+
| 'center'
|
|
256
|
+
| 'topLeading'
|
|
257
|
+
| 'top'
|
|
258
|
+
| 'topTrailing'
|
|
259
|
+
| 'leading'
|
|
260
|
+
| 'trailing'
|
|
261
|
+
| 'bottomLeading'
|
|
262
|
+
| 'bottom'
|
|
263
|
+
| 'bottomTrailing';
|
|
264
|
+
}
|
|
265
|
+
|
|
266
|
+
export interface ZStackNode extends BaseNode {
|
|
267
|
+
type: 'ZStack';
|
|
268
|
+
props?: ZStackProps;
|
|
269
|
+
children: LayoutNode[];
|
|
270
|
+
}
|
|
271
|
+
|
|
272
|
+
export interface GridProps extends ContainerProps {
|
|
273
|
+
/** Số cột của lưới (mặc định 2) */
|
|
274
|
+
columns?: number;
|
|
275
|
+
/** Khoảng cách ngang giữa các cột (mặc định 8) */
|
|
276
|
+
columnSpacing?: number;
|
|
277
|
+
/** Khoảng cách dọc giữa các hàng (mặc định 8) */
|
|
278
|
+
rowSpacing?: number;
|
|
279
|
+
}
|
|
280
|
+
|
|
281
|
+
export interface GridNode extends BaseNode {
|
|
282
|
+
type: 'Grid';
|
|
283
|
+
props?: GridProps;
|
|
284
|
+
children: LayoutNode[];
|
|
285
|
+
}
|
|
286
|
+
|
|
287
|
+
export interface DividerNode extends BaseNode {
|
|
288
|
+
type: 'Divider';
|
|
289
|
+
props?: {
|
|
290
|
+
color?: DynamicColor;
|
|
291
|
+
thickness?: number;
|
|
292
|
+
direction?: 'horizontal' | 'vertical';
|
|
293
|
+
dashed?: boolean;
|
|
294
|
+
marginVertical?: number;
|
|
295
|
+
marginHorizontal?: number;
|
|
296
|
+
};
|
|
297
|
+
}
|
|
298
|
+
|
|
299
|
+
export interface GaugeNode extends BaseNode {
|
|
300
|
+
type: 'Gauge';
|
|
301
|
+
props: {
|
|
302
|
+
/** Giá trị tiến độ từ 0.0 đến 1.0 */
|
|
303
|
+
value: number;
|
|
304
|
+
/** Chuỗi hiển thị chính giữa đồng hồ (vd "85%", "120 km/h", "420") */
|
|
305
|
+
valueText?: string;
|
|
306
|
+
/** Nhãn phụ bên dưới đồng hồ (vd "KPI", "Kcal", "AQI") */
|
|
307
|
+
label?: string;
|
|
308
|
+
/** Nhãn cực tiểu (góc trái dưới, vd "0") */
|
|
309
|
+
minLabel?: string;
|
|
310
|
+
/** Nhãn cực đại (góc phải dưới, vd "100") */
|
|
311
|
+
maxLabel?: string;
|
|
312
|
+
tintColor?: string;
|
|
313
|
+
trackColor?: string;
|
|
314
|
+
textColor?: string;
|
|
315
|
+
labelColor?: string;
|
|
316
|
+
/** Kích thước đường kính đồng hồ (mặc định 64) */
|
|
317
|
+
size?: number;
|
|
318
|
+
/** Độ dày nét vẽ cung đồng hồ (mặc định 7) */
|
|
319
|
+
strokeWidth?: number;
|
|
320
|
+
/** Tự động ẩn hoặc làm mờ đồng hồ khi màn hình khóa */
|
|
321
|
+
privacySensitive?: boolean;
|
|
322
|
+
};
|
|
323
|
+
}
|
|
324
|
+
|
|
325
|
+
export interface ChartNode extends BaseNode {
|
|
326
|
+
type: 'Chart';
|
|
327
|
+
props: {
|
|
328
|
+
/** Kiểu biểu đồ: 'bar' (cột) | 'line' (đường xu hướng Sparkline) */
|
|
329
|
+
style?: 'bar' | 'line';
|
|
330
|
+
/** Mảng dữ liệu số (ví dụ [45, 72, 60, 95, 80, 110, 92]) */
|
|
331
|
+
values: number[];
|
|
332
|
+
/** Nhãn trục ngang tương ứng (ví dụ ['T2', 'T3', 'T4', 'T5', 'T6', 'T7', 'CN']) */
|
|
333
|
+
labels?: string[];
|
|
334
|
+
tintColor?: string;
|
|
335
|
+
secondaryColor?: string;
|
|
336
|
+
labelColor?: string;
|
|
337
|
+
/** Chiều cao vùng vẽ biểu đồ (mặc định 56) */
|
|
338
|
+
height?: number;
|
|
339
|
+
/** Có hiển thị chấm tròn tại các đỉnh của biểu đồ đường không */
|
|
340
|
+
showDots?: boolean;
|
|
341
|
+
/** Tự động ẩn hoặc làm mờ biểu đồ khi màn hình khóa */
|
|
342
|
+
privacySensitive?: boolean;
|
|
343
|
+
};
|
|
344
|
+
}
|
|
345
|
+
|
|
346
|
+
export interface ToggleNode extends BaseNode {
|
|
347
|
+
type: 'Toggle';
|
|
348
|
+
props: {
|
|
349
|
+
/** Mã định danh toggle (tự động gắn tiền tố 'toggle:' nếu chưa có) */
|
|
350
|
+
actionId: string;
|
|
351
|
+
label: string;
|
|
352
|
+
subtitle?: string;
|
|
353
|
+
/** 'checkbox' (ô tích) | 'switch' (công tắc gạt) */
|
|
354
|
+
style?: 'checkbox' | 'switch';
|
|
355
|
+
checked?: boolean;
|
|
356
|
+
tintColor?: string;
|
|
357
|
+
textColor?: string;
|
|
358
|
+
checkedTextColor?: string;
|
|
359
|
+
fontSize?: number;
|
|
360
|
+
strikethroughOnCheck?: boolean;
|
|
361
|
+
};
|
|
362
|
+
}
|
|
363
|
+
|
|
364
|
+
export interface BadgeNode extends BaseNode {
|
|
365
|
+
type: 'Badge';
|
|
366
|
+
props: {
|
|
367
|
+
text: string;
|
|
368
|
+
systemName?: string;
|
|
369
|
+
backgroundColor?: string;
|
|
370
|
+
textColor?: string;
|
|
371
|
+
borderColor?: string;
|
|
372
|
+
borderWidth?: number;
|
|
373
|
+
fontSize?: number;
|
|
374
|
+
paddingHorizontal?: number;
|
|
375
|
+
paddingVertical?: number;
|
|
376
|
+
borderRadius?: number;
|
|
377
|
+
};
|
|
378
|
+
}
|
|
379
|
+
|
|
380
|
+
export interface LinkProps extends ContainerProps {
|
|
381
|
+
/** URL Deep Link mở màn hình cụ thể trong App (vd 'fastdo://orders/9920') */
|
|
382
|
+
deepLink?: string;
|
|
383
|
+
/** Hoặc chạy Action ngầm trên Widget ('page:...', 'toggle:...', 'refresh') */
|
|
384
|
+
actionId?: string;
|
|
385
|
+
}
|
|
386
|
+
|
|
387
|
+
export interface LinkNode extends BaseNode {
|
|
388
|
+
type: 'Link';
|
|
389
|
+
props: LinkProps;
|
|
390
|
+
children: LayoutNode[];
|
|
391
|
+
}
|
|
392
|
+
|
|
393
|
+
export interface EqualizerProps {
|
|
394
|
+
/** Trạng thái đang phát nhạc hay tạm dừng (mặc định: true) */
|
|
395
|
+
isPlaying?: boolean;
|
|
396
|
+
/** Số lượng thanh sóng nhạc (mặc định: 4, từ 3 đến 8) */
|
|
397
|
+
barCount?: number;
|
|
398
|
+
/** Màu sắc của thanh sóng nhạc (mặc định: '#10B981' - xanh Spotify / Apple Music) */
|
|
399
|
+
tintColor?: string;
|
|
400
|
+
/** Chiều cao tối đa của thanh sóng (mặc định: 16) */
|
|
401
|
+
height?: number;
|
|
402
|
+
/** Độ rộng của mỗi thanh (mặc định: 3) */
|
|
403
|
+
barWidth?: number;
|
|
404
|
+
/** Khoảng cách giữa các thanh (mặc định: 2) */
|
|
405
|
+
spacing?: number;
|
|
406
|
+
/**
|
|
407
|
+
* Frame sóng nhạc (số nguyên tăng dần). iOS không cho Live Activity / Widget tự chạy animation lặp,
|
|
408
|
+
* nên app cần cập nhật `phase` định kỳ (vd. mỗi ~1s khi đang phát) — renderer sẽ animate chuyển tiếp
|
|
409
|
+
* độ cao các thanh giữa 2 frame. Bỏ trống = hiển thị icon sóng tĩnh.
|
|
410
|
+
*/
|
|
411
|
+
phase?: number;
|
|
412
|
+
/** Mức âm lượng thực tế từng thanh (0..1). Nếu truyền, ưu tiên hơn `phase`. */
|
|
413
|
+
levels?: number[];
|
|
414
|
+
}
|
|
415
|
+
|
|
416
|
+
export interface EqualizerNode extends BaseNode {
|
|
417
|
+
type: 'Equalizer';
|
|
418
|
+
props?: EqualizerProps;
|
|
419
|
+
}
|
|
420
|
+
|
|
421
|
+
export interface CustomNode extends BaseNode {
|
|
422
|
+
type: 'Custom';
|
|
423
|
+
props: {
|
|
424
|
+
/** Tên định danh Component đã đăng ký trong DynamicNodeRegistry (Swift / Kotlin) */
|
|
425
|
+
componentName: string;
|
|
426
|
+
[key: string]: any;
|
|
427
|
+
};
|
|
428
|
+
children?: LayoutNode[];
|
|
429
|
+
}
|
|
430
|
+
|
|
431
|
+
export type LayoutNode =
|
|
432
|
+
| VStackNode
|
|
433
|
+
| HStackNode
|
|
434
|
+
| ZStackNode
|
|
435
|
+
| GridNode
|
|
436
|
+
| DividerNode
|
|
437
|
+
| TextNode
|
|
438
|
+
| TimerNode
|
|
439
|
+
| ProgressNode
|
|
440
|
+
| GaugeNode
|
|
441
|
+
| ChartNode
|
|
442
|
+
| ImageNode
|
|
443
|
+
| SpacerNode
|
|
444
|
+
| ButtonNode
|
|
445
|
+
| ToggleNode
|
|
446
|
+
| BadgeNode
|
|
447
|
+
| LinkNode
|
|
448
|
+
| EqualizerNode
|
|
449
|
+
| CustomNode;
|
|
450
|
+
|
|
451
|
+
export interface DynamicIslandConfig {
|
|
452
|
+
compactLeading: LayoutNode;
|
|
453
|
+
compactTrailing: LayoutNode;
|
|
454
|
+
minimal?: LayoutNode;
|
|
455
|
+
expanded?: {
|
|
456
|
+
leading?: LayoutNode;
|
|
457
|
+
trailing?: LayoutNode;
|
|
458
|
+
bottom?: LayoutNode;
|
|
459
|
+
center?: LayoutNode;
|
|
460
|
+
};
|
|
461
|
+
}
|
|
462
|
+
|
|
463
|
+
export interface PhaseConfig {
|
|
464
|
+
id: string;
|
|
465
|
+
triggerTimestamp: number;
|
|
466
|
+
layoutOverride?: LayoutNode;
|
|
467
|
+
alertTitle?: string;
|
|
468
|
+
alertBody?: string;
|
|
469
|
+
}
|
|
470
|
+
|
|
471
|
+
export interface StartActivityOptions {
|
|
472
|
+
activityId: string;
|
|
473
|
+
lockScreen: LayoutNode;
|
|
474
|
+
dynamicIsland?: DynamicIslandConfig;
|
|
475
|
+
phases?: PhaseConfig[];
|
|
476
|
+
staleTimestamp?: number;
|
|
477
|
+
alertTitle?: string;
|
|
478
|
+
alertBody?: string;
|
|
479
|
+
}
|
|
480
|
+
|
|
481
|
+
export interface UpdateActivityOptions {
|
|
482
|
+
activityId: string;
|
|
483
|
+
lockScreen?: LayoutNode;
|
|
484
|
+
dynamicIsland?: DynamicIslandConfig;
|
|
485
|
+
staleTimestamp?: number;
|
|
486
|
+
alertTitle?: string;
|
|
487
|
+
alertBody?: string;
|
|
488
|
+
}
|
|
489
|
+
|
|
490
|
+
export interface EndActivityOptions {
|
|
491
|
+
/**
|
|
492
|
+
* Chính sách kết thúc Live Activity trên hệ thống:
|
|
493
|
+
* - 'immediate': Biến mất ngay lập tức (mặc định)
|
|
494
|
+
* - 'default': Giữ lại thẻ hoàn thành trên màn hình khóa tối đa 4 tiếng (như Grab/Shopee)
|
|
495
|
+
* - 'afterDate': Giữ lại trong số giây xác định rồi tự động ẩn
|
|
496
|
+
*/
|
|
497
|
+
dismissalPolicy?: 'immediate' | 'default' | 'afterDate';
|
|
498
|
+
/** Số giây giữ lại trên Lock Screen (dùng khi dismissalPolicy = 'afterDate', mặc định 900 = 15 phút) */
|
|
499
|
+
dismissalAfterSeconds?: number;
|
|
500
|
+
/** Layout Lock Screen tổng kết cuối cùng hiển thị trước khi phiên Live Activity đóng */
|
|
501
|
+
finalLockScreen?: LayoutNode;
|
|
502
|
+
/** Layout Dynamic Island tổng kết cuối cùng trước khi phiên Live Activity đóng */
|
|
503
|
+
finalDynamicIsland?: DynamicIslandConfig;
|
|
504
|
+
}
|
|
505
|
+
|
|
506
|
+
export interface WidgetSinglePageConfig {
|
|
507
|
+
small?: LayoutNode;
|
|
508
|
+
medium?: LayoutNode;
|
|
509
|
+
large?: LayoutNode;
|
|
510
|
+
/** Màn hình khóa iOS 16+: Tiện ích hình chữ nhật bo góc dưới đồng hồ */
|
|
511
|
+
accessoryRectangular?: LayoutNode;
|
|
512
|
+
/** Màn hình khóa iOS 16+: Tiện ích ô tròn nhỏ dưới đồng hồ (Gauge / Circular Progress / Icon) */
|
|
513
|
+
accessoryCircular?: LayoutNode;
|
|
514
|
+
/** Màn hình khóa iOS 16+: Tiện ích 1 dòng chữ nhỏ trên đồng hồ */
|
|
515
|
+
accessoryInline?: LayoutNode;
|
|
516
|
+
}
|
|
517
|
+
|
|
518
|
+
export interface WidgetLayoutConfig extends WidgetSinglePageConfig {
|
|
519
|
+
/**
|
|
520
|
+
* Danh sách các trang/tab của Widget để chuyển qua lại ngay trên mặt Widget (không mở App).
|
|
521
|
+
* Ví dụ: { shift: { small, medium, large }, todo: { small, medium, large } }
|
|
522
|
+
*/
|
|
523
|
+
pages?: Record<string, WidgetSinglePageConfig>;
|
|
524
|
+
/** Thứ tự các trang khi bấm nút 'page:next' hoặc 'page:prev' */
|
|
525
|
+
pageOrder?: string[];
|
|
526
|
+
/** Trang hiển thị mặc định ban đầu */
|
|
527
|
+
initialPage?: string;
|
|
528
|
+
/**
|
|
529
|
+
* URL Deep Link khi người dùng chạm vào bất kỳ đâu trên mặt Widget (mở App đến màn hình đích).
|
|
530
|
+
* Rất quan trọng cho Small Widget vì iOS chỉ cho phép 1 liên kết cho toàn bộ widget nhỏ.
|
|
531
|
+
*/
|
|
532
|
+
rootDeepLink?: string;
|
|
533
|
+
/**
|
|
534
|
+
* Cấu hình màu nền container hoặc gradient (chuẩn iOS 17 StandBy Mode & macOS Desktop).
|
|
535
|
+
*/
|
|
536
|
+
containerBackground?: {
|
|
537
|
+
backgroundColor?: DynamicColor;
|
|
538
|
+
gradientColors?: string[];
|
|
539
|
+
};
|
|
540
|
+
}
|
|
541
|
+
|
|
542
|
+
export interface WidgetTimelineEntry {
|
|
543
|
+
/** Epoch timestamp (giây hoặc mili-giây) hoặc chuỗi ISO thời điểm chuyển sang layout này */
|
|
544
|
+
date: number | string;
|
|
545
|
+
/** Cấu hình layout tại mốc thời gian tương ứng */
|
|
546
|
+
layout: WidgetLayoutConfig;
|
|
547
|
+
}
|
|
548
|
+
|
|
549
|
+
export interface WidgetTimelineConfig {
|
|
550
|
+
/** Danh sách các mốc thời gian và layout tương ứng */
|
|
551
|
+
entries: WidgetTimelineEntry[];
|
|
552
|
+
/**
|
|
553
|
+
* Chính sách làm mới khi chạy hết Timeline:
|
|
554
|
+
* - 'atEnd': Tự động yêu cầu timeline mới khi hết danh sách (mặc định)
|
|
555
|
+
* - 'never': Không tự động làm mới thêm nữa
|
|
556
|
+
* - 'afterDate': Yêu cầu làm mới sau một mốc thời gian xác định
|
|
557
|
+
*/
|
|
558
|
+
policy?: 'atEnd' | 'never' | 'afterDate';
|
|
559
|
+
/** Timestamp (epoch giây hoặc ms) tiếp tục nạp timeline mới khi policy = 'afterDate' */
|
|
560
|
+
afterDate?: number | string;
|
|
561
|
+
}
|
|
562
|
+
|
|
563
|
+
export interface WidgetConfigOption {
|
|
564
|
+
id: string;
|
|
565
|
+
title: string;
|
|
566
|
+
subtitle?: string;
|
|
567
|
+
icon?: string;
|
|
568
|
+
}
|
|
569
|
+
|
|
570
|
+
export interface WidgetRemoteConfig {
|
|
571
|
+
/** URL API mà Widget Extension sẽ tự gọi ngầm (kể cả khi người dùng đã kill App chính) */
|
|
572
|
+
url: string;
|
|
573
|
+
/** HTTP Method (mặc định 'GET') */
|
|
574
|
+
method?: 'GET' | 'POST';
|
|
575
|
+
/** Headers xác thực (ví dụ { Authorization: 'Bearer ...' }) */
|
|
576
|
+
headers?: Record<string, string>;
|
|
577
|
+
/** Chu kỳ tự động gọi lại API tính bằng phút (mặc định 15 phút) */
|
|
578
|
+
refreshIntervalMinutes?: number;
|
|
579
|
+
}
|
|
580
|
+
|
|
581
|
+
export interface LiveActivityPushTokens {
|
|
582
|
+
/** Token APNs của thiết bị (Device Token 64-hex chars) dùng cho Push Notification / Silent Push */
|
|
583
|
+
devicePushToken: string | null;
|
|
584
|
+
/** Token APNs Push-to-Start (iOS 17.2+) để Backend kích hoạt mở mới Live Activity từ xa */
|
|
585
|
+
pushToStartToken: string | null;
|
|
586
|
+
/** Token APNs Update của phiên Live Activity hiện tại để Backend đẩy bản cập nhật / kết thúc */
|
|
587
|
+
activityUpdateToken: string | null;
|
|
588
|
+
/** Map toàn bộ { [activityId]: updateToken } đang hoạt động */
|
|
589
|
+
allActivityUpdateTokens: Record<string, string>;
|
|
590
|
+
}
|
|
591
|
+
|
|
592
|
+
export interface ActiveActivityInfo {
|
|
593
|
+
activityId: string;
|
|
594
|
+
pushToken?: string;
|
|
595
|
+
}
|