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
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 và tự động dọn dẹp state khi component unmount.
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
- return await LiveActivity.update({
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