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/lib/index.js CHANGED
@@ -1,40 +1,66 @@
1
- import React from 'react';
2
- import { AppRegistry, NativeEventEmitter, NativeModules, Platform } from 'react-native';
3
- const { LiveActivityModule } = NativeModules;
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ var __importDefault = (this && this.__importDefault) || function (mod) {
17
+ return (mod && mod.__esModule) ? mod : { "default": mod };
18
+ };
19
+ Object.defineProperty(exports, "__esModule", { value: true });
20
+ exports.defineWidgetConfig = exports.StyleSheet = exports.AudioPlayer = exports.SharedStorage = exports.ControlWidget = exports.Widget = exports.LiveActivity = exports.unregisterAction = exports.registerActionHandler = exports.registerAction = void 0;
21
+ exports.defineWidgetsConfig = defineWidgetsConfig;
22
+ const react_1 = __importDefault(require("react"));
23
+ const react_native_1 = require("react-native");
24
+ const ir_1 = require("./ir");
25
+ const builder_1 = require("./builder");
26
+ const { LiveActivityModule } = react_native_1.NativeModules;
4
27
  if (!LiveActivityModule && typeof __DEV__ !== 'undefined' && __DEV__) {
5
28
  console.warn('[react-native-live-widgets] Native module not found. ' +
6
29
  'Please ensure you have run "npx react-native-live-widgets init" and re-compiled your app.');
7
30
  }
8
31
  const liveActivityEmitter = LiveActivityModule
9
- ? new NativeEventEmitter(LiveActivityModule)
32
+ ? new react_native_1.NativeEventEmitter(LiveActivityModule)
10
33
  : null;
11
34
  const DEVICE_TOKEN_CHANGED_EVENT = 'DevicePushTokenChanged';
12
35
  const TOKEN_CHANGED_EVENT = 'LiveActivityTokenChanged';
13
36
  const UPDATE_TOKEN_CHANGED_EVENT = 'LiveActivityUpdateTokenChanged';
14
37
  const ACTION_CLICKED_EVENT = 'LiveActivityActionClicked';
15
- import { actionHandlers, globalActionHandlers, registerAction, registerActionHandler, unregisterAction, } from './dispatcher';
16
- export { registerAction, registerActionHandler, unregisterAction };
17
- export * from './hooks';
18
- export * from './jsx';
19
- export * from './preview';
20
- import { renderToWidget } from './jsx';
38
+ const STATE_CHANGED_EVENT = 'LiveActivityStateChanged';
39
+ const dispatcher_1 = require("./dispatcher");
40
+ Object.defineProperty(exports, "registerAction", { enumerable: true, get: function () { return dispatcher_1.registerAction; } });
41
+ Object.defineProperty(exports, "registerActionHandler", { enumerable: true, get: function () { return dispatcher_1.registerActionHandler; } });
42
+ Object.defineProperty(exports, "unregisterAction", { enumerable: true, get: function () { return dispatcher_1.unregisterAction; } });
43
+ __exportStar(require("./jsx"), exports);
44
+ __exportStar(require("./preview"), exports);
45
+ const jsx_1 = require("./jsx");
21
46
  // Tự động lắng nghe action event từ Native để dispatch tới các hàm TypeScript đã đăng ký
22
47
  if (liveActivityEmitter) {
23
48
  liveActivityEmitter.addListener(ACTION_CLICKED_EVENT, async (event) => {
24
49
  const actionId = event?.actionId || '';
25
50
  const activityId = event?.activityId || '';
26
- const handler = actionHandlers.get(actionId);
51
+ const payload = { ...(event || {}), actionId, activityId };
52
+ const handler = dispatcher_1.actionHandlers.get(actionId);
27
53
  if (handler) {
28
54
  try {
29
- await handler({ actionId, activityId });
55
+ await handler(payload);
30
56
  }
31
57
  catch (e) {
32
58
  console.warn(`[react-native-live-widgets] Error executing action '${actionId}':`, e);
33
59
  }
34
60
  }
35
- for (const globalHandler of globalActionHandlers) {
61
+ for (const globalHandler of dispatcher_1.globalActionHandlers) {
36
62
  try {
37
- await globalHandler(actionId, { actionId, activityId });
63
+ await globalHandler(actionId, payload);
38
64
  }
39
65
  catch (e) {
40
66
  console.warn(`[react-native-live-widgets] Error in global action handler for '${actionId}':`, e);
@@ -42,8 +68,113 @@ if (liveActivityEmitter) {
42
68
  }
43
69
  });
44
70
  }
71
+ function convertIfJsx(node) {
72
+ if (!node)
73
+ return node;
74
+ if (react_1.default.isValidElement(node) || node?.$$typeof || typeof node?.type === 'function') {
75
+ return (0, jsx_1.renderToWidget)(node);
76
+ }
77
+ return node;
78
+ }
79
+ function normalizeDynamicIsland(island) {
80
+ if (!island || typeof island !== 'object')
81
+ return island;
82
+ const normalized = { ...island };
83
+ if (normalized.compactLeading)
84
+ normalized.compactLeading = convertIfJsx(normalized.compactLeading);
85
+ if (normalized.compactTrailing)
86
+ normalized.compactTrailing = convertIfJsx(normalized.compactTrailing);
87
+ if (normalized.minimal)
88
+ normalized.minimal = convertIfJsx(normalized.minimal);
89
+ if (normalized.expanded && typeof normalized.expanded === 'object') {
90
+ normalized.expanded = {
91
+ ...normalized.expanded,
92
+ leading: convertIfJsx(normalized.expanded.leading),
93
+ trailing: convertIfJsx(normalized.expanded.trailing),
94
+ center: convertIfJsx(normalized.expanded.center),
95
+ bottom: convertIfJsx(normalized.expanded.bottom),
96
+ };
97
+ }
98
+ return normalized;
99
+ }
100
+ function normalizeActivityPayload(options) {
101
+ const opts = { ...options };
102
+ if (opts.lockScreen)
103
+ opts.lockScreen = convertIfJsx(opts.lockScreen);
104
+ if (opts.staleLockScreen)
105
+ opts.staleLockScreen = convertIfJsx(opts.staleLockScreen);
106
+ if (opts.expiredLockScreen)
107
+ opts.expiredLockScreen = convertIfJsx(opts.expiredLockScreen);
108
+ if (opts.dynamicIsland)
109
+ opts.dynamicIsland = normalizeDynamicIsland(opts.dynamicIsland);
110
+ if (opts.staleDynamicIsland)
111
+ opts.staleDynamicIsland = normalizeDynamicIsland(opts.staleDynamicIsland);
112
+ if (opts.alertConfig && typeof opts.alertConfig === 'object') {
113
+ if (opts.alertConfig.title && !opts.alertTitle)
114
+ opts.alertTitle = opts.alertConfig.title;
115
+ if (opts.alertConfig.body && !opts.alertBody)
116
+ opts.alertBody = opts.alertConfig.body;
117
+ if (opts.alertConfig.sound && !opts.alertSound)
118
+ opts.alertSound = opts.alertConfig.sound;
119
+ }
120
+ if (typeof opts.autoEndAfterSeconds === 'number' && opts.autoEndAfterSeconds > 0 && !opts.scheduledEndTimestamp) {
121
+ opts.scheduledEndTimestamp = Date.now() / 1000.0 + opts.autoEndAfterSeconds;
122
+ }
123
+ return opts;
124
+ }
125
+ function normalizeSinglePageConfig(cfg) {
126
+ if (!cfg || typeof cfg !== 'object')
127
+ return cfg;
128
+ return {
129
+ ...cfg,
130
+ small: convertIfJsx(cfg.small),
131
+ medium: convertIfJsx(cfg.medium),
132
+ large: convertIfJsx(cfg.large),
133
+ extraLarge: convertIfJsx(cfg.extraLarge),
134
+ standBy: convertIfJsx(cfg.standBy),
135
+ accessoryRectangular: convertIfJsx(cfg.accessoryRectangular),
136
+ accessoryCircular: convertIfJsx(cfg.accessoryCircular),
137
+ accessoryInline: convertIfJsx(cfg.accessoryInline),
138
+ };
139
+ }
140
+ function normalizeWidgetLayoutConfig(layoutConfig) {
141
+ let finalLayout = layoutConfig;
142
+ if (react_1.default.isValidElement(finalLayout) ||
143
+ finalLayout?.$$typeof ||
144
+ typeof finalLayout?.type === 'function') {
145
+ finalLayout = { medium: (0, jsx_1.renderToWidget)(finalLayout) };
146
+ }
147
+ else if (finalLayout && typeof finalLayout === 'object') {
148
+ const c = normalizeSinglePageConfig(finalLayout);
149
+ if (c.pages && typeof c.pages === 'object') {
150
+ const convertedPages = {};
151
+ for (const [pageKey, pageCfg] of Object.entries(c.pages)) {
152
+ convertedPages[pageKey] = normalizeSinglePageConfig(pageCfg);
153
+ }
154
+ c.pages = convertedPages;
155
+ }
156
+ finalLayout = c;
157
+ }
158
+ return finalLayout;
159
+ }
160
+ function resolveLayoutObjectTemplates(value, flatVars) {
161
+ if (typeof value === 'string') {
162
+ return (0, builder_1.resolveTemplateString)(value, flatVars);
163
+ }
164
+ if (Array.isArray(value)) {
165
+ return value.map((item) => resolveLayoutObjectTemplates(item, flatVars));
166
+ }
167
+ if (value && typeof value === 'object') {
168
+ const out = {};
169
+ for (const [k, v] of Object.entries(value)) {
170
+ out[k] = resolveLayoutObjectTemplates(v, flatVars);
171
+ }
172
+ return out;
173
+ }
174
+ return value;
175
+ }
45
176
  // ─── 1. LIVE ACTIVITY & LIVE UPDATE ──────────────────────────────────────────
46
- export const LiveActivity = {
177
+ exports.LiveActivity = {
47
178
  /**
48
179
  * Khởi động một Live Activity (iOS) hoặc Live Update / Ongoing Notification (Android).
49
180
  */
@@ -51,11 +182,7 @@ export const LiveActivity = {
51
182
  if (!LiveActivityModule?.start)
52
183
  return false;
53
184
  try {
54
- const opts = { ...options };
55
- if (React.isValidElement(opts.lockScreen)) {
56
- opts.lockScreen = renderToWidget(opts.lockScreen);
57
- }
58
- const payload = JSON.stringify(opts);
185
+ const payload = JSON.stringify(normalizeActivityPayload(options));
59
186
  return await LiveActivityModule.start(options.activityId, payload);
60
187
  }
61
188
  catch (error) {
@@ -70,11 +197,7 @@ export const LiveActivity = {
70
197
  if (!LiveActivityModule?.update)
71
198
  return false;
72
199
  try {
73
- const opts = { ...options };
74
- if (React.isValidElement(opts.lockScreen)) {
75
- opts.lockScreen = renderToWidget(opts.lockScreen);
76
- }
77
- const payload = JSON.stringify(opts);
200
+ const payload = JSON.stringify(normalizeActivityPayload(options));
78
201
  return await LiveActivityModule.update(options.activityId, payload);
79
202
  }
80
203
  catch (error) {
@@ -88,11 +211,13 @@ export const LiveActivity = {
88
211
  end: async (activityId, options) => {
89
212
  try {
90
213
  if (options && (LiveActivityModule?.endWithOptions || LiveActivityModule?.endActivity)) {
91
- const payloadJson = options.finalLockScreen || options.finalDynamicIsland
214
+ const finalLock = options.finalLockScreen ? convertIfJsx(options.finalLockScreen) : undefined;
215
+ const finalIsland = options.finalDynamicIsland ? normalizeDynamicIsland(options.finalDynamicIsland) : undefined;
216
+ const payloadJson = finalLock || finalIsland
92
217
  ? JSON.stringify({
93
218
  activityId,
94
- lockScreen: options.finalLockScreen,
95
- dynamicIsland: options.finalDynamicIsland,
219
+ lockScreen: finalLock,
220
+ dynamicIsland: finalIsland,
96
221
  })
97
222
  : null;
98
223
  const nativeOptions = {
@@ -242,9 +367,9 @@ export const LiveActivity = {
242
367
  * Trả về hàm hủy đăng ký (unsubscribe).
243
368
  */
244
369
  registerAction: (actionId, handler) => {
245
- actionHandlers.set(actionId, handler);
370
+ dispatcher_1.actionHandlers.set(actionId, handler);
246
371
  return () => {
247
- actionHandlers.delete(actionId);
372
+ dispatcher_1.actionHandlers.delete(actionId);
248
373
  };
249
374
  },
250
375
  /**
@@ -252,16 +377,16 @@ export const LiveActivity = {
252
377
  * Nhận `(actionId, payload)`. Trả về hàm hủy đăng ký (unsubscribe).
253
378
  */
254
379
  registerActionHandler: (handler) => {
255
- return registerActionHandler(handler);
380
+ return (0, dispatcher_1.registerActionHandler)(handler);
256
381
  },
257
382
  /**
258
383
  * Hủy đăng ký action handler theo `actionId`.
259
384
  */
260
385
  unregisterAction: (actionId) => {
261
- actionHandlers.delete(actionId);
386
+ dispatcher_1.actionHandlers.delete(actionId);
262
387
  },
263
388
  /**
264
- * Lấy danh sách các phiên Live Activity đang chạy trên thiết bị (ID và Push Token).
389
+ * Lấy danh sách các phiên Live Activity đang chạy trên thiết bị (kèm trạng thái Stale, RelevanceScore, ScheduledEnd và Push Token).
265
390
  * Giúp ứng dụng khôi phục lại trạng thái giao diện khi mở lại App.
266
391
  */
267
392
  getActiveActivities: async () => {
@@ -272,6 +397,12 @@ export const LiveActivity = {
272
397
  const list = await LiveActivityModule.getActiveActivities();
273
398
  return (list || []).map((item) => ({
274
399
  activityId: item.activityId || '',
400
+ systemActivityId: item.systemActivityId,
401
+ activityState: item.activityState,
402
+ isStale: Boolean(item.isStale ?? item.activityState === 'stale'),
403
+ relevanceScore: typeof item.relevanceScore === 'number' ? item.relevanceScore : undefined,
404
+ staleTimestamp: typeof item.staleTimestamp === 'number' ? item.staleTimestamp : undefined,
405
+ scheduledEndTimestamp: typeof item.scheduledEndTimestamp === 'number' ? item.scheduledEndTimestamp : undefined,
275
406
  pushToken: item.pushToken,
276
407
  }));
277
408
  }
@@ -280,6 +411,59 @@ export const LiveActivity = {
280
411
  return [];
281
412
  }
282
413
  },
414
+ /**
415
+ * Lấy thông tin chi tiết của một Live Activity cụ thể theo activityId.
416
+ */
417
+ get: async (activityId) => {
418
+ const list = await exports.LiveActivity.getActiveActivities();
419
+ return list.find((a) => a.activityId === activityId || a.systemActivityId === activityId) ?? null;
420
+ },
421
+ /**
422
+ * Kiểm tra nhanh xem một Live Activity cụ thể có đang chạy trên thiết bị hay không.
423
+ */
424
+ isActive: async (activityId) => {
425
+ const info = await exports.LiveActivity.get(activityId);
426
+ return Boolean(info && info.activityState !== 'ended' && info.activityState !== 'dismissed' && info.activityState !== 'expired');
427
+ },
428
+ /**
429
+ * Lắng nghe sự kiện chuyển đổi vòng đời Live Activity (`active`, `started_by_push`, `stale`, `expired`, `ended`, `dismissed`).
430
+ */
431
+ onStateChange: (listener) => {
432
+ if (!liveActivityEmitter)
433
+ return () => { };
434
+ const sub = liveActivityEmitter.addListener(STATE_CHANGED_EVENT, (event) => {
435
+ if (!event)
436
+ return;
437
+ listener({
438
+ activityId: event.activityId || '',
439
+ systemActivityId: event.systemActivityId,
440
+ state: event.state || 'active',
441
+ timestamp: typeof event.timestamp === 'number' ? event.timestamp : Date.now() / 1000.0,
442
+ pushToken: event.pushToken,
443
+ });
444
+ });
445
+ return () => sub.remove();
446
+ },
447
+ /**
448
+ * Kiểm tra và tự động kết thúc các Live Activity đã quá hạn `scheduledEndTimestamp` (dọn dẹp các phiên bị kẹt).
449
+ * Trả về danh sách các `activityId` đã được dọn dẹp.
450
+ */
451
+ cleanupExpired: async () => {
452
+ const list = await exports.LiveActivity.getActiveActivities();
453
+ const nowSec = Date.now() / 1000.0;
454
+ const cleaned = [];
455
+ for (const item of list) {
456
+ const endTs = item.scheduledEndTimestamp;
457
+ if (typeof endTs === 'number' && endTs > 0) {
458
+ const normalizedEnd = endTs > 10000000000 ? endTs / 1000.0 : endTs;
459
+ if (nowSec >= normalizedEnd) {
460
+ await exports.LiveActivity.end(item.activityId, { dismissalPolicy: 'immediate' });
461
+ cleaned.push(item.activityId);
462
+ }
463
+ }
464
+ }
465
+ return cleaned;
466
+ },
283
467
  /**
284
468
  * Kiểm tra xem người dùng có cấp quyền Hoạt động trực tiếp (Live Activities) trong Cài đặt máy hay không.
285
469
  */
@@ -323,7 +507,7 @@ export const LiveActivity = {
323
507
  * Android 16+: Kiểm tra quyền Promoted Ongoing Notifications.
324
508
  */
325
509
  canPostPromoted: async () => {
326
- if (Platform.OS !== 'android' || !LiveActivityModule?.canPostPromoted) {
510
+ if (react_native_1.Platform.OS !== 'android' || !LiveActivityModule?.canPostPromoted) {
327
511
  return false;
328
512
  }
329
513
  return await LiveActivityModule.canPostPromoted();
@@ -333,19 +517,19 @@ export const LiveActivity = {
333
517
  * Hoạt động ngay cả khi App chính đã bị người dùng vuốt đóng (Killed).
334
518
  */
335
519
  registerBackgroundActionHandler: (handler) => {
336
- if (Platform.OS === 'android') {
520
+ if (react_native_1.Platform.OS === 'android') {
337
521
  try {
338
- AppRegistry.registerHeadlessTask('LiveActivityBackgroundTask', () => async (taskData) => {
522
+ react_native_1.AppRegistry.registerHeadlessTask('LiveActivityBackgroundTask', () => async (taskData) => {
339
523
  const actionId = taskData?.actionId || '';
340
524
  const activityId = taskData?.activityId || '';
341
525
  if (handler) {
342
526
  await handler(actionId, activityId);
343
527
  }
344
- const registered = actionHandlers.get(actionId);
528
+ const registered = dispatcher_1.actionHandlers.get(actionId);
345
529
  if (registered) {
346
530
  await registered({ actionId, activityId });
347
531
  }
348
- for (const globalHandler of globalActionHandlers) {
532
+ for (const globalHandler of dispatcher_1.globalActionHandlers) {
349
533
  try {
350
534
  await globalHandler(actionId, { actionId, activityId });
351
535
  }
@@ -362,7 +546,7 @@ export const LiveActivity = {
362
546
  },
363
547
  };
364
548
  // ─── 2. HOME SCREEN WIDGETS ──────────────────────────────────────────────────
365
- export const Widget = {
549
+ exports.Widget = {
366
550
  /**
367
551
  * Yêu cầu hệ điều hành iOS và Android vẽ lại toàn bộ Home Screen Widgets ngay lập tức.
368
552
  */
@@ -412,32 +596,11 @@ export const Widget = {
412
596
  layoutConfig = widgetKeyOrConfig;
413
597
  appGroup = typeof layoutConfigOrAppGroup === 'string' ? layoutConfigOrAppGroup : undefined;
414
598
  }
415
- let finalLayout = layoutConfig;
416
- const convertIfJsx = (node) => {
417
- if (!node)
418
- return node;
419
- if (React.isValidElement(node) || node?.$$typeof || typeof node?.type === 'function') {
420
- return renderToWidget(node);
421
- }
422
- return node;
423
- };
424
- if (React.isValidElement(finalLayout) || finalLayout?.$$typeof || typeof finalLayout?.type === 'function') {
425
- finalLayout = { medium: renderToWidget(finalLayout) };
426
- }
427
- else if (finalLayout && typeof finalLayout === 'object') {
428
- const c = { ...finalLayout };
429
- c.small = convertIfJsx(c.small);
430
- c.medium = convertIfJsx(c.medium);
431
- c.large = convertIfJsx(c.large);
432
- c.accessoryRectangular = convertIfJsx(c.accessoryRectangular);
433
- c.accessoryCircular = convertIfJsx(c.accessoryCircular);
434
- c.accessoryInline = convertIfJsx(c.accessoryInline);
435
- finalLayout = c;
436
- }
437
- const saved = await SharedStorage.set(`widget_layout_${widgetKey}`, finalLayout, appGroup);
599
+ const finalLayout = normalizeWidgetLayoutConfig(layoutConfig);
600
+ const saved = await exports.SharedStorage.set(`widget_layout_${widgetKey}`, finalLayout, appGroup);
438
601
  if (!saved)
439
602
  return false;
440
- return await Widget.reloadAll();
603
+ return await exports.Widget.reloadAll();
441
604
  }
442
605
  catch (error) {
443
606
  console.warn('[react-native-live-widgets] setLayout error:', error);
@@ -448,7 +611,7 @@ export const Widget = {
448
611
  * Cập nhật layout động cho Widget (Alias tiện ích cho `Widget.setLayout`).
449
612
  */
450
613
  update: async (widgetKeyOrConfig, layoutConfigOrAppGroup, maybeAppGroup) => {
451
- return Widget.setLayout(widgetKeyOrConfig, layoutConfigOrAppGroup, maybeAppGroup);
614
+ return exports.Widget.setLayout(widgetKeyOrConfig, layoutConfigOrAppGroup, maybeAppGroup);
452
615
  },
453
616
  /**
454
617
  * Thiết lập dòng thời gian tự động (Timeline Entries) cho Widget.
@@ -457,14 +620,21 @@ export const Widget = {
457
620
  */
458
621
  setTimeline: async (widgetKey, timelineConfig, appGroup) => {
459
622
  try {
460
- const formattedEntries = timelineConfig.entries.map((entry) => ({
461
- date: typeof entry.date === 'string'
462
- ? new Date(entry.date).getTime() / 1000.0
463
- : entry.date > 10000000000
464
- ? entry.date / 1000.0
465
- : entry.date,
466
- layout: entry.layout,
467
- }));
623
+ const formattedEntries = timelineConfig.entries.map((entry) => {
624
+ let entryLayout = normalizeWidgetLayoutConfig(entry.layout);
625
+ if (entry.data && typeof entry.data === 'object') {
626
+ const flatVars = (0, builder_1.flattenDataObject)(entry.data);
627
+ entryLayout = resolveLayoutObjectTemplates(entryLayout, flatVars);
628
+ }
629
+ return {
630
+ date: typeof entry.date === 'string'
631
+ ? new Date(entry.date).getTime() / 1000.0
632
+ : entry.date > 10000000000
633
+ ? entry.date / 1000.0
634
+ : entry.date,
635
+ layout: entryLayout,
636
+ };
637
+ });
468
638
  const formattedConfig = {
469
639
  entries: formattedEntries,
470
640
  policy: timelineConfig.policy || 'atEnd',
@@ -476,10 +646,10 @@ export const Widget = {
476
646
  : timelineConfig.afterDate
477
647
  : undefined,
478
648
  };
479
- const saved = await SharedStorage.set(`widget_timeline_${widgetKey}`, formattedConfig, appGroup);
649
+ const saved = await exports.SharedStorage.set(`widget_timeline_${widgetKey}`, formattedConfig, appGroup);
480
650
  if (!saved)
481
651
  return false;
482
- return await Widget.reloadAll();
652
+ return await exports.Widget.reloadAll();
483
653
  }
484
654
  catch (error) {
485
655
  console.warn('[react-native-live-widgets] setTimeline error:', error);
@@ -491,30 +661,34 @@ export const Widget = {
491
661
  * Ví dụ: Danh sách các Dự án, Chi nhánh, Ca làm để người dùng chọn khi nhấn giữ Widget ngoài Home Screen.
492
662
  */
493
663
  setConfigurationOptions: async (widgetKey, options, appGroup) => {
494
- return await SharedStorage.set(`widget_config_options_${widgetKey}`, options, appGroup);
664
+ return await exports.SharedStorage.set(`widget_config_options_${widgetKey}`, options, appGroup);
495
665
  },
496
666
  /**
497
667
  * Lấy ID tùy chọn cấu hình đang được người dùng chọn ghim trên Widget.
498
668
  */
499
669
  getSelectedConfiguration: async (widgetKey, appGroup) => {
500
- return await SharedStorage.get(`widget_selected_config_${widgetKey}`, appGroup);
670
+ return await exports.SharedStorage.get(`widget_selected_config_${widgetKey}`, appGroup);
501
671
  },
502
672
  /**
503
673
  * Thiết lập lựa chọn cấu hình cho Widget từ trong ứng dụng.
504
674
  */
505
675
  setSelectedConfiguration: async (widgetKey, selectedId, appGroup) => {
506
- const ok = await SharedStorage.set(`widget_selected_config_${widgetKey}`, selectedId, appGroup);
507
- await Widget.reloadAll();
676
+ const ok = await exports.SharedStorage.set(`widget_selected_config_${widgetKey}`, selectedId, appGroup);
677
+ await exports.Widget.reloadAll();
508
678
  return ok;
509
679
  },
510
680
  /**
511
- * Cấu hình Endpoint API để bản thân Widget Extension tự chạy ngầm lấy dữ liệu mới
512
- * theo chu kỳ (`getTimeline`) hoặc khi bấm nút `actionId: 'refresh'` trên mặt Widget,
513
- * kể cả khi người dùng đã vuốt tắt (Kill) hoàn toàn ứng dụng chính!
681
+ * Cấu hình Background Data Engine 2.0 để Widget Extension tự gọi API ngầm (REST, Custom Headers,
682
+ * Cache TTL, ETag/304, Retry/Backoff, Timeout, Multiple Sources, Data Transform, Schema Validation,
683
+ * Auth Token Refresh & Error State) kể cả khi App chính đã bị đóng hoàn toàn.
684
+ *
685
+ * Lưu ý hệ điều hành: Apple WidgetKit quản lý ngân sách reload động (~40–70 lần/ngày tùy mức sử dụng,
686
+ * `refreshIntervalMinutes` chỉ là mốc sớm nhất đề xuất chứ không cam kết chạy đúng mỗi 15 phút khi app đóng);
687
+ * Android cũng áp dụng Doze Mode / App Standby cho background task.
514
688
  *
515
689
  * Hỗ trợ gọi linh hoạt:
516
- * - `Widget.setRemoteConfig('main', { url, refreshIntervalMinutes }, appGroup?)`
517
- * - `Widget.setRemoteConfig({ url, intervalMinutes }, appGroup?)` (tự động gán widgetKey = 'main')
690
+ * - `Widget.setRemoteConfig('main', config, appGroup?)`
691
+ * - `Widget.setRemoteConfig(config, appGroup?)` (tự động gán widgetKey = 'main')
518
692
  */
519
693
  setRemoteConfig: async (widgetKeyOrConfig, remoteConfigOrAppGroup, maybeAppGroup) => {
520
694
  try {
@@ -530,28 +704,75 @@ export const Widget = {
530
704
  remoteConfig = widgetKeyOrConfig;
531
705
  appGroup = typeof remoteConfigOrAppGroup === 'string' ? remoteConfigOrAppGroup : undefined;
532
706
  }
533
- if (remoteConfig.intervalMinutes !== undefined && remoteConfig.refreshIntervalMinutes === undefined) {
534
- remoteConfig.refreshIntervalMinutes = remoteConfig.intervalMinutes;
707
+ const finalConfig = { ...remoteConfig };
708
+ if (finalConfig.intervalMinutes !== undefined &&
709
+ finalConfig.refreshIntervalMinutes === undefined) {
710
+ finalConfig.refreshIntervalMinutes = finalConfig.intervalMinutes;
711
+ }
712
+ else if (finalConfig.refreshIntervalMinutes !== undefined &&
713
+ finalConfig.intervalMinutes === undefined) {
714
+ finalConfig.intervalMinutes = finalConfig.refreshIntervalMinutes;
535
715
  }
536
- else if (remoteConfig.refreshIntervalMinutes !== undefined && remoteConfig.intervalMinutes === undefined) {
537
- remoteConfig.intervalMinutes = remoteConfig.refreshIntervalMinutes;
716
+ if (finalConfig.errorFallback) {
717
+ finalConfig.errorFallback = convertIfJsx(finalConfig.errorFallback);
538
718
  }
539
- const saved = await SharedStorage.set(`widget_remote_config_${widgetKey}`, remoteConfig, appGroup);
719
+ const saved = await exports.SharedStorage.set(`widget_remote_config_${widgetKey}`, finalConfig, appGroup);
540
720
  if (!saved)
541
721
  return false;
542
- return await Widget.reloadAll();
722
+ return await exports.Widget.reloadAll();
543
723
  }
544
724
  catch (error) {
545
725
  console.warn('[react-native-live-widgets] setRemoteConfig error:', error);
546
726
  return false;
547
727
  }
548
728
  },
729
+ /**
730
+ * Đẩy dữ liệu có cấu trúc (Structured Data Binding) từ JS/TS xuống Native Shared Storage
731
+ * để Home Screen Widget cập nhật tức thì mà không cần dựng lại toàn bộ cây layout.
732
+ *
733
+ * Hỗ trợ gọi linh hoạt:
734
+ * - `Widget.setData('main', data, appGroup?)`
735
+ * - `Widget.setData(data, appGroup?)` (tự động gán widgetKey = 'main')
736
+ */
737
+ setData: async (widgetKeyOrData, dataOrAppGroup, maybeAppGroup) => {
738
+ try {
739
+ let widgetKey = 'main';
740
+ let dataObj;
741
+ let appGroup;
742
+ if (typeof widgetKeyOrData === 'string') {
743
+ widgetKey = widgetKeyOrData;
744
+ dataObj = dataOrAppGroup || {};
745
+ appGroup = maybeAppGroup;
746
+ }
747
+ else {
748
+ dataObj = widgetKeyOrData || {};
749
+ appGroup = typeof dataOrAppGroup === 'string' ? dataOrAppGroup : undefined;
750
+ }
751
+ const flattened = (0, builder_1.flattenDataObject)(dataObj);
752
+ const saved = await exports.SharedStorage.set(`widget_bound_data_${widgetKey}`, flattened, appGroup);
753
+ if (!saved)
754
+ return false;
755
+ return await exports.Widget.reloadAll();
756
+ }
757
+ catch (error) {
758
+ console.warn('[react-native-live-widgets] setData error:', error);
759
+ return false;
760
+ }
761
+ },
762
+ /**
763
+ * Tạo Proxy Data Binding có cấu trúc & gợi ý kiểu TypeScript cho JSX/DSL Widget (`data.user.name`, `data.attendance.progress.divide(100)`).
764
+ */
765
+ createDataBinding: builder_1.createDataBinding,
766
+ /**
767
+ * Tạo chuỗi token binding (`{{path|pipe}}`) cho hệ thống Background Data Engine 2.0.
768
+ */
769
+ bind: builder_1.UI.bind,
549
770
  /** Đăng ký lắng nghe tương tác nút bấm từ Widget theo `actionId` */
550
- registerAction: registerAction,
771
+ registerAction: dispatcher_1.registerAction,
551
772
  /** Đăng ký lắng nghe toàn cục tất cả tương tác nút bấm từ Widget (alias) */
552
- onWidgetAction: registerActionHandler,
773
+ onWidgetAction: dispatcher_1.registerActionHandler,
553
774
  /** Đăng ký lắng nghe toàn cục tất cả tương tác nút bấm từ Widget */
554
- registerActionHandler: registerActionHandler,
775
+ registerActionHandler: dispatcher_1.registerActionHandler,
555
776
  /**
556
777
  * (Android 8.0+) Mở hộp thoại hệ thống cho phép người dùng ghim trực tiếp Tiện ích ra màn hình chính ngay từ trong ứng dụng.
557
778
  * Trên iOS, hàm trả về false vì Apple chỉ cho phép người dùng tự thêm tiện ích từ thư viện Widget của hệ điều hành.
@@ -580,9 +801,91 @@ export const Widget = {
580
801
  return false;
581
802
  }
582
803
  },
804
+ /**
805
+ * 📊 Bảng tra cứu năng lực nền tảng (Platform Capability & Fallback Matrix).
806
+ * Giúp ứng dụng xác định chính xác tính năng nào được hỗ trợ thực tế trên thiết bị đang chạy.
807
+ */
808
+ getCapabilities: async () => {
809
+ const isIOS = react_native_1.Platform.OS === 'ios';
810
+ const isAndroid = react_native_1.Platform.OS === 'android';
811
+ const osVerNum = parseFloat(String(react_native_1.Platform.Version)) || 0;
812
+ let hasIsland = false;
813
+ if (isIOS) {
814
+ try {
815
+ hasIsland = LiveActivityModule?.isDynamicIslandSupported
816
+ ? await LiveActivityModule.isDynamicIslandSupported()
817
+ : osVerNum >= 16.1;
818
+ }
819
+ catch {
820
+ hasIsland = osVerNum >= 16.1;
821
+ }
822
+ }
823
+ return {
824
+ platform: isIOS ? 'ios' : 'android',
825
+ osVersion: react_native_1.Platform.Version,
826
+ supportsLiveActivities: isIOS ? osVerNum >= 16.1 : osVerNum >= 26,
827
+ supportsDynamicIsland: hasIsland,
828
+ supportsAndroidLiveUpdates: isAndroid && osVerNum >= 36,
829
+ supportsHomeWidgets: isIOS ? osVerNum >= 14.0 : osVerNum >= 26,
830
+ supportsInteractiveIntents: isIOS ? osVerNum >= 17.0 : true,
831
+ supportsGradients: true,
832
+ supportsShadows: true,
833
+ supportsDashedBorders: true,
834
+ supportsDynamicType: true,
835
+ supportsRTL: true,
836
+ supportsTintedMode: isIOS ? osVerNum >= 18.0 : isAndroid,
837
+ supportsNumericAnimation: isIOS && osVerNum >= 16.0,
838
+ supportsAccessibility: true,
839
+ };
840
+ },
841
+ /**
842
+ * 🎛️ Cấu hình Control Widget (iOS 18+ Control Center / Lock Screen Controls / Action Button & Android Quick Settings).
843
+ */
844
+ setControl: async (controlId, config, appGroup) => {
845
+ try {
846
+ return await exports.SharedStorage.set(`widget_control_${controlId}`, config, appGroup);
847
+ }
848
+ catch (error) {
849
+ console.warn('[react-native-live-widgets] setControl error:', error);
850
+ return false;
851
+ }
852
+ },
853
+ /**
854
+ * Đọc cấu hình và trạng thái hiện tại của Control Widget từ Shared Storage.
855
+ */
856
+ getControlState: async (controlId, appGroup) => {
857
+ try {
858
+ return await exports.SharedStorage.get(`widget_control_${controlId}`, appGroup);
859
+ }
860
+ catch {
861
+ return null;
862
+ }
863
+ },
864
+ /**
865
+ * 🌲 Biên dịch cây DSL sang UI Intermediate Representation (IR & Semantic Tree - Phase 2).
866
+ */
867
+ compileIR: (layout) => {
868
+ return (0, ir_1.compileToIR)(layout);
869
+ },
870
+ /**
871
+ * 🔍 Phân tích và in ra bản đồ kiến trúc IR, Semantic Tree và Kế hoạch phân bổ Renderer Planner.
872
+ */
873
+ inspectIR: (layout) => {
874
+ return (0, ir_1.inspectIR)(layout);
875
+ },
876
+ };
877
+ /**
878
+ * 🎛️ Namespace cấu hình & quản lý Control Widget đa nền tảng
879
+ * (iOS 18+ Control Center / Lock Screen Controls / Action Button & Android Quick Settings Tile).
880
+ */
881
+ exports.ControlWidget = {
882
+ set: exports.Widget.setControl,
883
+ getState: exports.Widget.getControlState,
884
+ button: builder_1.UI.ControlButton,
885
+ toggle: builder_1.UI.ControlToggle,
583
886
  };
584
887
  // ─── 3. SHARED STORAGE (App Groups & SharedPreferences) ─────────────────────
585
- export const SharedStorage = {
888
+ exports.SharedStorage = {
586
889
  /**
587
890
  * Lưu dữ liệu vào App Group (iOS) hoặc SharedPreferences (Android) để Widget đọc.
588
891
  */
@@ -649,7 +952,7 @@ export const SharedStorage = {
649
952
  }
650
953
  },
651
954
  };
652
- export const AudioPlayer = {
955
+ exports.AudioPlayer = {
653
956
  /**
654
957
  * Phát nhạc trực tiếp từ URL (hỗ trợ stream mp3, m4a, aac, wav...)
655
958
  * và đăng ký hệ thống Now Playing của iOS (hiện trên Dynamic Island & Lock Screen như Spotify).
@@ -722,7 +1025,22 @@ export const AudioPlayer = {
722
1025
  }
723
1026
  },
724
1027
  };
725
- export * from './types';
726
- export * from './builder';
727
- export { StyleSheet } from './builder';
1028
+ __exportStar(require("./types"), exports);
1029
+ __exportStar(require("./builder"), exports);
1030
+ __exportStar(require("./ir"), exports);
1031
+ var builder_2 = require("./builder");
1032
+ Object.defineProperty(exports, "StyleSheet", { enumerable: true, get: function () { return builder_2.StyleSheet; } });
1033
+ __exportStar(require("./hooks"), exports);
1034
+ /**
1035
+ * Định nghĩa cấu hình các Widget cho ứng dụng với đầy đủ Type Safety và gợi ý thuộc tính IDE.
1036
+ * Cấu hình này được công cụ Codegen (`npx react-native-live-widgets codegen`) đọc
1037
+ * để tự động tạo file LiveWidgetsBundle.swift cho iOS WidgetKit.
1038
+ */
1039
+ function defineWidgetsConfig(config) {
1040
+ return config;
1041
+ }
1042
+ /**
1043
+ * Alias cho `defineWidgetsConfig` (hỗ trợ cả dạng số ít và số nhiều)
1044
+ */
1045
+ exports.defineWidgetConfig = defineWidgetsConfig;
728
1046
  //# sourceMappingURL=index.js.map