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
package/src/hooks.ts
CHANGED
|
@@ -7,7 +7,10 @@ import {
|
|
|
7
7
|
} from './dispatcher';
|
|
8
8
|
import { LiveActivity, SharedStorage, Widget } from './index';
|
|
9
9
|
import {
|
|
10
|
+
ActiveActivityInfo,
|
|
11
|
+
LiveActivityLifecycleState,
|
|
10
12
|
LiveActivityPushTokens,
|
|
13
|
+
LiveActivityStateEvent,
|
|
11
14
|
StartActivityOptions,
|
|
12
15
|
UpdateActivityOptions,
|
|
13
16
|
EndActivityOptions,
|
|
@@ -66,6 +69,12 @@ export interface UseLiveActivityResult {
|
|
|
66
69
|
activityId: string | null;
|
|
67
70
|
/** Trạng thái phiên có đang hoạt động hay không */
|
|
68
71
|
isActive: boolean;
|
|
72
|
+
/** Trạng thái vòng đời chi tiết ('active', 'started_by_push', 'stale', 'expired', 'ended', 'dismissed') */
|
|
73
|
+
lifecycleState: LiveActivityLifecycleState | null;
|
|
74
|
+
/** Cờ báo Live Activity hiện tại đã chuyển sang trạng thái cũ (Stale) hay chưa */
|
|
75
|
+
isStale: boolean;
|
|
76
|
+
/** Danh sách tất cả các Live Activity đang chạy đồng thời trên thiết bị */
|
|
77
|
+
activities: ActiveActivityInfo[];
|
|
69
78
|
/** Token cập nhật tiện ích (iOS activityUpdateToken hoặc devicePushToken) */
|
|
70
79
|
pushToken: string | null;
|
|
71
80
|
/** Toàn bộ bộ 3 loại Push Token (deviceToken, pushToStart, activityUpdateToken) */
|
|
@@ -76,29 +85,55 @@ export interface UseLiveActivityResult {
|
|
|
76
85
|
update: (options: Omit<UpdateActivityOptions, 'activityId'>) => Promise<boolean>;
|
|
77
86
|
/** Kết thúc Live Activity hiện tại */
|
|
78
87
|
end: (options?: EndActivityOptions) => Promise<boolean>;
|
|
88
|
+
/** Làm mới danh sách các Live Activity đang hoạt động */
|
|
89
|
+
refreshActivities: () => Promise<ActiveActivityInfo[]>;
|
|
90
|
+
/** Dọn dẹp tự động các Live Activity đã quá hạn scheduledEndTimestamp */
|
|
91
|
+
cleanupExpired: () => Promise<string[]>;
|
|
79
92
|
}
|
|
80
93
|
|
|
81
94
|
/**
|
|
82
95
|
* 🎣 React Hook quản lý vòng đời trọn vẹn của một Live Activity / Android Ongoing Notification.
|
|
83
|
-
* Tương thích Fast Refresh
|
|
96
|
+
* Tương thích Fast Refresh, tự động lắng nghe Stale/Expired/Push-to-Start và quản lý nhiều phiên đồng thời.
|
|
84
97
|
*
|
|
85
98
|
* ```typescript
|
|
86
|
-
* const { activityId, isActive, start, update, end } = useLiveActivity();
|
|
87
|
-
*
|
|
88
|
-
* // Bắt đầu khi bấm nút
|
|
89
|
-
* await start({
|
|
90
|
-
* activityId: 'order_123',
|
|
91
|
-
* lockScreen: UI.VStack(...)
|
|
92
|
-
* });
|
|
99
|
+
* const { activityId, isActive, isStale, activities, start, update, end } = useLiveActivity();
|
|
93
100
|
* ```
|
|
94
101
|
*/
|
|
95
102
|
export function useLiveActivity(initialActivityId?: string): UseLiveActivityResult {
|
|
96
103
|
const [currentId, setCurrentId] = useState<string | null>(initialActivityId || null);
|
|
97
104
|
const [isActive, setIsActive] = useState<boolean>(!!initialActivityId);
|
|
105
|
+
const [lifecycleState, setLifecycleState] = useState<LiveActivityLifecycleState | null>(
|
|
106
|
+
initialActivityId ? 'active' : null
|
|
107
|
+
);
|
|
108
|
+
const [isStale, setIsStale] = useState<boolean>(false);
|
|
109
|
+
const [activities, setActivities] = useState<ActiveActivityInfo[]>([]);
|
|
98
110
|
const [pushTokens, setPushTokens] = useState<LiveActivityPushTokens | null>(null);
|
|
99
111
|
|
|
112
|
+
const refreshActivities = useCallback(async (): Promise<ActiveActivityInfo[]> => {
|
|
113
|
+
try {
|
|
114
|
+
const list = await LiveActivity.getActiveActivities();
|
|
115
|
+
setActivities(list);
|
|
116
|
+
if (currentId) {
|
|
117
|
+
const matched = list.find((a) => a.activityId === currentId);
|
|
118
|
+
if (matched) {
|
|
119
|
+
const active = matched.activityState !== 'ended' && matched.activityState !== 'dismissed' && matched.activityState !== 'expired';
|
|
120
|
+
setIsActive(active);
|
|
121
|
+
setIsStale(Boolean(matched.isStale));
|
|
122
|
+
if (matched.activityState) {
|
|
123
|
+
setLifecycleState(matched.activityState as LiveActivityLifecycleState);
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
return list;
|
|
128
|
+
} catch {
|
|
129
|
+
return [];
|
|
130
|
+
}
|
|
131
|
+
}, [currentId]);
|
|
132
|
+
|
|
100
133
|
useEffect(() => {
|
|
101
134
|
let mounted = true;
|
|
135
|
+
refreshActivities();
|
|
136
|
+
|
|
102
137
|
if (currentId) {
|
|
103
138
|
LiveActivity.getAllPushTokens(currentId)
|
|
104
139
|
.then((tokens: LiveActivityPushTokens) => {
|
|
@@ -108,10 +143,27 @@ export function useLiveActivity(initialActivityId?: string): UseLiveActivityResu
|
|
|
108
143
|
})
|
|
109
144
|
.catch(() => {});
|
|
110
145
|
}
|
|
146
|
+
|
|
147
|
+
const unsubState = LiveActivity.onStateChange((ev: LiveActivityStateEvent) => {
|
|
148
|
+
if (!mounted) return;
|
|
149
|
+
refreshActivities();
|
|
150
|
+
if (!currentId || ev.activityId === currentId || ev.state === 'started_by_push') {
|
|
151
|
+
if (ev.state === 'started_by_push' && !currentId) {
|
|
152
|
+
setCurrentId(ev.activityId);
|
|
153
|
+
}
|
|
154
|
+
if (ev.activityId === currentId || !currentId) {
|
|
155
|
+
setLifecycleState(ev.state);
|
|
156
|
+
setIsStale(ev.state === 'stale');
|
|
157
|
+
setIsActive(ev.state === 'active' || ev.state === 'started_by_push' || ev.state === 'stale');
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
});
|
|
161
|
+
|
|
111
162
|
return () => {
|
|
112
163
|
mounted = false;
|
|
164
|
+
unsubState();
|
|
113
165
|
};
|
|
114
|
-
}, [currentId]);
|
|
166
|
+
}, [currentId, refreshActivities]);
|
|
115
167
|
|
|
116
168
|
const start = useCallback(
|
|
117
169
|
async (options: StartActivityOptions): Promise<string | null> => {
|
|
@@ -119,9 +171,13 @@ export function useLiveActivity(initialActivityId?: string): UseLiveActivityResu
|
|
|
119
171
|
if (ok) {
|
|
120
172
|
setCurrentId(options.activityId);
|
|
121
173
|
setIsActive(true);
|
|
174
|
+
setIsStale(false);
|
|
175
|
+
setLifecycleState('active');
|
|
122
176
|
try {
|
|
123
177
|
const tokens = await LiveActivity.getAllPushTokens(options.activityId);
|
|
124
178
|
setPushTokens(tokens);
|
|
179
|
+
const list = await LiveActivity.getActiveActivities();
|
|
180
|
+
setActivities(list);
|
|
125
181
|
} catch (_) {}
|
|
126
182
|
return options.activityId;
|
|
127
183
|
}
|
|
@@ -133,12 +189,18 @@ export function useLiveActivity(initialActivityId?: string): UseLiveActivityResu
|
|
|
133
189
|
const update = useCallback(
|
|
134
190
|
async (options: Omit<UpdateActivityOptions, 'activityId'>): Promise<boolean> => {
|
|
135
191
|
if (!currentId) return false;
|
|
136
|
-
|
|
192
|
+
const ok = await LiveActivity.update({
|
|
137
193
|
activityId: currentId,
|
|
138
194
|
...options,
|
|
139
195
|
});
|
|
196
|
+
if (ok) {
|
|
197
|
+
setIsStale(false);
|
|
198
|
+
setLifecycleState('active');
|
|
199
|
+
refreshActivities();
|
|
200
|
+
}
|
|
201
|
+
return ok;
|
|
140
202
|
},
|
|
141
|
-
[currentId]
|
|
203
|
+
[currentId, refreshActivities]
|
|
142
204
|
);
|
|
143
205
|
|
|
144
206
|
const end = useCallback(
|
|
@@ -147,20 +209,34 @@ export function useLiveActivity(initialActivityId?: string): UseLiveActivityResu
|
|
|
147
209
|
const ok = await LiveActivity.end(currentId, options);
|
|
148
210
|
if (ok) {
|
|
149
211
|
setIsActive(false);
|
|
212
|
+
setIsStale(false);
|
|
213
|
+
setLifecycleState('ended');
|
|
214
|
+
refreshActivities();
|
|
150
215
|
}
|
|
151
216
|
return ok;
|
|
152
217
|
},
|
|
153
|
-
[currentId]
|
|
218
|
+
[currentId, refreshActivities]
|
|
154
219
|
);
|
|
155
220
|
|
|
221
|
+
const cleanupExpired = useCallback(async (): Promise<string[]> => {
|
|
222
|
+
const cleaned = await LiveActivity.cleanupExpired();
|
|
223
|
+
await refreshActivities();
|
|
224
|
+
return cleaned;
|
|
225
|
+
}, [refreshActivities]);
|
|
226
|
+
|
|
156
227
|
return {
|
|
157
228
|
activityId: currentId,
|
|
158
229
|
isActive,
|
|
230
|
+
lifecycleState,
|
|
231
|
+
isStale,
|
|
232
|
+
activities,
|
|
159
233
|
pushToken: pushTokens?.activityUpdateToken || pushTokens?.devicePushToken || null,
|
|
160
234
|
pushTokens,
|
|
161
235
|
start,
|
|
162
236
|
update,
|
|
163
237
|
end,
|
|
238
|
+
refreshActivities,
|
|
239
|
+
cleanupExpired,
|
|
164
240
|
};
|
|
165
241
|
}
|
|
166
242
|
|