react-native-live-widgets 1.2.0 → 1.2.1

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 (50) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/README.md +40 -1
  3. package/android/src/main/java/com/reactnativeliveactivity/renderer/DynamicWidgetCanvasRenderer.kt +443 -46
  4. package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetStateStore.kt +86 -28
  5. package/android/src/main/java/com/reactnativeliveactivity/widgets/DynamicHomeScreenWidgetProvider.kt +126 -56
  6. package/android/src/main/res/layout/rn_live_widget_hit_zone.xml +16 -0
  7. package/android/src/main/res/layout/rn_live_widget_host.xml +16 -87
  8. package/docs/GUIDE-EN.md +241 -0
  9. package/docs/GUIDE-VI.md +266 -0
  10. package/docs/index.html +1140 -259
  11. package/docs/llms-full.txt +26 -0
  12. package/docs/llms.txt +8 -0
  13. package/ios/Models/DynamicLayoutModels.swift +6 -1
  14. package/ios/Renderer/DynamicNodeView.swift +169 -14
  15. package/ios/Widgets/DynamicHomeScreenWidget.swift +5 -0
  16. package/lib/builder.d.ts.map +1 -1
  17. package/lib/builder.js +65 -11
  18. package/lib/builder.js.map +1 -1
  19. package/lib/dispatcher.js +16 -10
  20. package/lib/dispatcher.js.map +1 -1
  21. package/lib/hooks.js +36 -31
  22. package/lib/hooks.js.map +1 -1
  23. package/lib/index.d.ts +17 -2
  24. package/lib/index.d.ts.map +1 -1
  25. package/lib/index.js +124 -50
  26. package/lib/index.js.map +1 -1
  27. package/lib/ir.d.ts +15 -0
  28. package/lib/ir.d.ts.map +1 -0
  29. package/lib/ir.js +379 -0
  30. package/lib/ir.js.map +1 -0
  31. package/lib/jsx.d.ts +9 -1
  32. package/lib/jsx.d.ts.map +1 -1
  33. package/lib/jsx.js +131 -84
  34. package/lib/jsx.js.map +1 -1
  35. package/lib/preview.d.ts +0 -23
  36. package/lib/preview.d.ts.map +1 -1
  37. package/lib/preview.js +373 -104
  38. package/lib/preview.js.map +1 -1
  39. package/lib/types.d.ts +204 -12
  40. package/lib/types.d.ts.map +1 -1
  41. package/lib/types.js +2 -1
  42. package/lib/types.js.map +1 -1
  43. package/package.json +2 -1
  44. package/src/builder.ts +57 -2
  45. package/src/index.ts +66 -1
  46. package/src/ir.ts +430 -0
  47. package/src/jsx.tsx +30 -0
  48. package/src/preview.tsx +356 -32
  49. package/src/react-native-env.d.ts +1 -0
  50. package/src/types.ts +253 -13
package/lib/hooks.js CHANGED
@@ -1,6 +1,11 @@
1
- import { useState, useEffect, useRef, useCallback } from 'react';
2
- import { registerAction, registerActionHandler, } from './dispatcher';
3
- import { LiveActivity, SharedStorage, Widget } from './index';
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.useWidgetAction = useWidgetAction;
4
+ exports.useLiveActivity = useLiveActivity;
5
+ exports.useWidgetState = useWidgetState;
6
+ const react_1 = require("react");
7
+ const dispatcher_1 = require("./dispatcher");
8
+ const index_1 = require("./index");
4
9
  /**
5
10
  * 🎣 React Hook an toàn tuyệt đối với Fast Refresh / Hot Reloading để lắng nghe
6
11
  * tương tác nút bấm trên Home Screen Widget hoặc Live Activity.
@@ -20,14 +25,14 @@ import { LiveActivity, SharedStorage, Widget } from './index';
20
25
  * });
21
26
  * ```
22
27
  */
23
- export function useWidgetAction(actionIdOrCallback, handler) {
24
- const savedHandler = useRef(undefined);
25
- useEffect(() => {
28
+ function useWidgetAction(actionIdOrCallback, handler) {
29
+ const savedHandler = (0, react_1.useRef)(undefined);
30
+ (0, react_1.useEffect)(() => {
26
31
  savedHandler.current = typeof actionIdOrCallback === 'function' ? actionIdOrCallback : handler;
27
32
  });
28
- useEffect(() => {
33
+ (0, react_1.useEffect)(() => {
29
34
  if (typeof actionIdOrCallback === 'function') {
30
- const unsubscribe = registerActionHandler((actionId, payload) => {
35
+ const unsubscribe = (0, dispatcher_1.registerActionHandler)((actionId, payload) => {
31
36
  if (typeof savedHandler.current === 'function') {
32
37
  savedHandler.current(actionId, payload);
33
38
  }
@@ -35,7 +40,7 @@ export function useWidgetAction(actionIdOrCallback, handler) {
35
40
  return unsubscribe;
36
41
  }
37
42
  else if (typeof actionIdOrCallback === 'string') {
38
- const unsubscribe = registerAction(actionIdOrCallback, (event) => {
43
+ const unsubscribe = (0, dispatcher_1.registerAction)(actionIdOrCallback, (event) => {
39
44
  if (typeof savedHandler.current === 'function') {
40
45
  savedHandler.current(event);
41
46
  }
@@ -58,14 +63,14 @@ export function useWidgetAction(actionIdOrCallback, handler) {
58
63
  * });
59
64
  * ```
60
65
  */
61
- export function useLiveActivity(initialActivityId) {
62
- const [currentId, setCurrentId] = useState(initialActivityId || null);
63
- const [isActive, setIsActive] = useState(!!initialActivityId);
64
- const [pushTokens, setPushTokens] = useState(null);
65
- useEffect(() => {
66
+ function useLiveActivity(initialActivityId) {
67
+ const [currentId, setCurrentId] = (0, react_1.useState)(initialActivityId || null);
68
+ const [isActive, setIsActive] = (0, react_1.useState)(!!initialActivityId);
69
+ const [pushTokens, setPushTokens] = (0, react_1.useState)(null);
70
+ (0, react_1.useEffect)(() => {
66
71
  let mounted = true;
67
72
  if (currentId) {
68
- LiveActivity.getAllPushTokens(currentId)
73
+ index_1.LiveActivity.getAllPushTokens(currentId)
69
74
  .then((tokens) => {
70
75
  if (mounted && tokens) {
71
76
  setPushTokens(tokens);
@@ -77,13 +82,13 @@ export function useLiveActivity(initialActivityId) {
77
82
  mounted = false;
78
83
  };
79
84
  }, [currentId]);
80
- const start = useCallback(async (options) => {
81
- const ok = await LiveActivity.start(options);
85
+ const start = (0, react_1.useCallback)(async (options) => {
86
+ const ok = await index_1.LiveActivity.start(options);
82
87
  if (ok) {
83
88
  setCurrentId(options.activityId);
84
89
  setIsActive(true);
85
90
  try {
86
- const tokens = await LiveActivity.getAllPushTokens(options.activityId);
91
+ const tokens = await index_1.LiveActivity.getAllPushTokens(options.activityId);
87
92
  setPushTokens(tokens);
88
93
  }
89
94
  catch (_) { }
@@ -91,18 +96,18 @@ export function useLiveActivity(initialActivityId) {
91
96
  }
92
97
  return null;
93
98
  }, []);
94
- const update = useCallback(async (options) => {
99
+ const update = (0, react_1.useCallback)(async (options) => {
95
100
  if (!currentId)
96
101
  return false;
97
- return await LiveActivity.update({
102
+ return await index_1.LiveActivity.update({
98
103
  activityId: currentId,
99
104
  ...options,
100
105
  });
101
106
  }, [currentId]);
102
- const end = useCallback(async (options) => {
107
+ const end = (0, react_1.useCallback)(async (options) => {
103
108
  if (!currentId)
104
109
  return false;
105
- const ok = await LiveActivity.end(currentId, options);
110
+ const ok = await index_1.LiveActivity.end(currentId, options);
106
111
  if (ok) {
107
112
  setIsActive(false);
108
113
  }
@@ -129,11 +134,11 @@ export function useLiveActivity(initialActivityId) {
129
134
  * setCounter(prev => prev + 1);
130
135
  * ```
131
136
  */
132
- export function useWidgetState(key, initialValue, appGroup) {
133
- const [state, setState] = useState(initialValue);
134
- useEffect(() => {
137
+ function useWidgetState(key, initialValue, appGroup) {
138
+ const [state, setState] = (0, react_1.useState)(initialValue);
139
+ (0, react_1.useEffect)(() => {
135
140
  let mounted = true;
136
- SharedStorage.get(key, appGroup)
141
+ index_1.SharedStorage.get(key, appGroup)
137
142
  .then((val) => {
138
143
  if (mounted && val !== null && val !== undefined) {
139
144
  setState(val);
@@ -144,19 +149,19 @@ export function useWidgetState(key, initialValue, appGroup) {
144
149
  mounted = false;
145
150
  };
146
151
  }, [key, appGroup]);
147
- const setWidgetState = useCallback(async (newValue) => {
152
+ const setWidgetState = (0, react_1.useCallback)(async (newValue) => {
148
153
  setState((prev) => {
149
154
  const resolved = typeof newValue === 'function' ? newValue(prev) : newValue;
150
- SharedStorage.set(key, resolved, appGroup)
155
+ index_1.SharedStorage.set(key, resolved, appGroup)
151
156
  .then(() => {
152
- Widget.reloadAll().catch(() => { });
157
+ index_1.Widget.reloadAll().catch(() => { });
153
158
  })
154
159
  .catch(() => { });
155
160
  return resolved;
156
161
  });
157
162
  }, [key, appGroup]);
158
- const reload = useCallback(async () => {
159
- const val = await SharedStorage.get(key, appGroup);
163
+ const reload = (0, react_1.useCallback)(async () => {
164
+ const val = await index_1.SharedStorage.get(key, appGroup);
160
165
  if (val !== null && val !== undefined) {
161
166
  setState(val);
162
167
  }
package/lib/hooks.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}
package/lib/index.d.ts CHANGED
@@ -1,8 +1,8 @@
1
- import { ActiveActivityInfo, EndActivityOptions, LiveActivityPushTokens, StartActivityOptions, UpdateActivityOptions, WidgetConfigOption, WidgetLayoutConfig, WidgetRemoteConfig, WidgetTimelineConfig } from './types';
1
+ import { ActiveActivityInfo, EndActivityOptions, LiveActivityPushTokens, StartActivityOptions, UpdateActivityOptions, WidgetCapabilities, WidgetConfigOption, WidgetLayoutConfig, WidgetRemoteConfig, WidgetTimelineConfig, WidgetIR } from './types';
2
2
  import { ActionHandler, GlobalActionHandler, registerAction, registerActionHandler, unregisterAction } from './dispatcher';
3
3
  export type { ActionHandler, GlobalActionHandler };
4
4
  export { registerAction, registerActionHandler, unregisterAction };
5
- export * from './hooks';
5
+ export type { WidgetCapabilities, GradientProps, ShadowProps, BorderStyle, TypographyStyle, FontDesign, } from './types';
6
6
  export * from './jsx';
7
7
  export * from './preview';
8
8
  export declare const LiveActivity: {
@@ -165,6 +165,19 @@ export declare const Widget: {
165
165
  * Kiểm tra xem thiết bị hiện tại có hỗ trợ ghim Tiện ích trực tiếp từ trong ứng dụng hay không (Chỉ Android API 26+).
166
166
  */
167
167
  isPinSupported: () => Promise<boolean>;
168
+ /**
169
+ * 📊 Bảng tra cứu năng lực nền tảng (Platform Capability & Fallback Matrix).
170
+ * 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.
171
+ */
172
+ getCapabilities: () => Promise<WidgetCapabilities>;
173
+ /**
174
+ * 🌲 Biên dịch cây DSL sang UI Intermediate Representation (IR & Semantic Tree - Phase 2).
175
+ */
176
+ compileIR: (layout: any) => WidgetIR;
177
+ /**
178
+ * 🔍 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.
179
+ */
180
+ inspectIR: (layout: any) => string;
168
181
  };
169
182
  export declare const SharedStorage: {
170
183
  /**
@@ -220,5 +233,7 @@ export declare const AudioPlayer: {
220
233
  };
221
234
  export * from './types';
222
235
  export * from './builder';
236
+ export * from './ir';
223
237
  export { StyleSheet } from './builder';
238
+ export * from './hooks';
224
239
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/lib/index.js CHANGED
@@ -1,29 +1,51 @@
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.StyleSheet = exports.AudioPlayer = exports.SharedStorage = exports.Widget = exports.LiveActivity = exports.unregisterAction = exports.registerActionHandler = exports.registerAction = void 0;
21
+ const react_1 = __importDefault(require("react"));
22
+ const react_native_1 = require("react-native");
23
+ const ir_1 = require("./ir");
24
+ const { LiveActivityModule } = react_native_1.NativeModules;
4
25
  if (!LiveActivityModule && typeof __DEV__ !== 'undefined' && __DEV__) {
5
26
  console.warn('[react-native-live-widgets] Native module not found. ' +
6
27
  'Please ensure you have run "npx react-native-live-widgets init" and re-compiled your app.');
7
28
  }
8
29
  const liveActivityEmitter = LiveActivityModule
9
- ? new NativeEventEmitter(LiveActivityModule)
30
+ ? new react_native_1.NativeEventEmitter(LiveActivityModule)
10
31
  : null;
11
32
  const DEVICE_TOKEN_CHANGED_EVENT = 'DevicePushTokenChanged';
12
33
  const TOKEN_CHANGED_EVENT = 'LiveActivityTokenChanged';
13
34
  const UPDATE_TOKEN_CHANGED_EVENT = 'LiveActivityUpdateTokenChanged';
14
35
  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';
36
+ const dispatcher_1 = require("./dispatcher");
37
+ Object.defineProperty(exports, "registerAction", { enumerable: true, get: function () { return dispatcher_1.registerAction; } });
38
+ Object.defineProperty(exports, "registerActionHandler", { enumerable: true, get: function () { return dispatcher_1.registerActionHandler; } });
39
+ Object.defineProperty(exports, "unregisterAction", { enumerable: true, get: function () { return dispatcher_1.unregisterAction; } });
40
+ __exportStar(require("./jsx"), exports);
41
+ __exportStar(require("./preview"), exports);
42
+ const jsx_1 = require("./jsx");
21
43
  // Tự động lắng nghe action event từ Native để dispatch tới các hàm TypeScript đã đăng ký
22
44
  if (liveActivityEmitter) {
23
45
  liveActivityEmitter.addListener(ACTION_CLICKED_EVENT, async (event) => {
24
46
  const actionId = event?.actionId || '';
25
47
  const activityId = event?.activityId || '';
26
- const handler = actionHandlers.get(actionId);
48
+ const handler = dispatcher_1.actionHandlers.get(actionId);
27
49
  if (handler) {
28
50
  try {
29
51
  await handler({ actionId, activityId });
@@ -32,7 +54,7 @@ if (liveActivityEmitter) {
32
54
  console.warn(`[react-native-live-widgets] Error executing action '${actionId}':`, e);
33
55
  }
34
56
  }
35
- for (const globalHandler of globalActionHandlers) {
57
+ for (const globalHandler of dispatcher_1.globalActionHandlers) {
36
58
  try {
37
59
  await globalHandler(actionId, { actionId, activityId });
38
60
  }
@@ -43,7 +65,7 @@ if (liveActivityEmitter) {
43
65
  });
44
66
  }
45
67
  // ─── 1. LIVE ACTIVITY & LIVE UPDATE ──────────────────────────────────────────
46
- export const LiveActivity = {
68
+ exports.LiveActivity = {
47
69
  /**
48
70
  * Khởi động một Live Activity (iOS) hoặc Live Update / Ongoing Notification (Android).
49
71
  */
@@ -52,8 +74,8 @@ export const LiveActivity = {
52
74
  return false;
53
75
  try {
54
76
  const opts = { ...options };
55
- if (React.isValidElement(opts.lockScreen)) {
56
- opts.lockScreen = renderToWidget(opts.lockScreen);
77
+ if (react_1.default.isValidElement(opts.lockScreen)) {
78
+ opts.lockScreen = (0, jsx_1.renderToWidget)(opts.lockScreen);
57
79
  }
58
80
  const payload = JSON.stringify(opts);
59
81
  return await LiveActivityModule.start(options.activityId, payload);
@@ -71,8 +93,8 @@ export const LiveActivity = {
71
93
  return false;
72
94
  try {
73
95
  const opts = { ...options };
74
- if (React.isValidElement(opts.lockScreen)) {
75
- opts.lockScreen = renderToWidget(opts.lockScreen);
96
+ if (react_1.default.isValidElement(opts.lockScreen)) {
97
+ opts.lockScreen = (0, jsx_1.renderToWidget)(opts.lockScreen);
76
98
  }
77
99
  const payload = JSON.stringify(opts);
78
100
  return await LiveActivityModule.update(options.activityId, payload);
@@ -242,9 +264,9 @@ export const LiveActivity = {
242
264
  * Trả về hàm hủy đăng ký (unsubscribe).
243
265
  */
244
266
  registerAction: (actionId, handler) => {
245
- actionHandlers.set(actionId, handler);
267
+ dispatcher_1.actionHandlers.set(actionId, handler);
246
268
  return () => {
247
- actionHandlers.delete(actionId);
269
+ dispatcher_1.actionHandlers.delete(actionId);
248
270
  };
249
271
  },
250
272
  /**
@@ -252,13 +274,13 @@ export const LiveActivity = {
252
274
  * Nhận `(actionId, payload)`. Trả về hàm hủy đăng ký (unsubscribe).
253
275
  */
254
276
  registerActionHandler: (handler) => {
255
- return registerActionHandler(handler);
277
+ return (0, dispatcher_1.registerActionHandler)(handler);
256
278
  },
257
279
  /**
258
280
  * Hủy đăng ký action handler theo `actionId`.
259
281
  */
260
282
  unregisterAction: (actionId) => {
261
- actionHandlers.delete(actionId);
283
+ dispatcher_1.actionHandlers.delete(actionId);
262
284
  },
263
285
  /**
264
286
  * Lấy danh sách các phiên Live Activity đang chạy trên thiết bị (ID và Push Token).
@@ -323,7 +345,7 @@ export const LiveActivity = {
323
345
  * Android 16+: Kiểm tra quyền Promoted Ongoing Notifications.
324
346
  */
325
347
  canPostPromoted: async () => {
326
- if (Platform.OS !== 'android' || !LiveActivityModule?.canPostPromoted) {
348
+ if (react_native_1.Platform.OS !== 'android' || !LiveActivityModule?.canPostPromoted) {
327
349
  return false;
328
350
  }
329
351
  return await LiveActivityModule.canPostPromoted();
@@ -333,19 +355,19 @@ export const LiveActivity = {
333
355
  * Hoạt động ngay cả khi App chính đã bị người dùng vuốt đóng (Killed).
334
356
  */
335
357
  registerBackgroundActionHandler: (handler) => {
336
- if (Platform.OS === 'android') {
358
+ if (react_native_1.Platform.OS === 'android') {
337
359
  try {
338
- AppRegistry.registerHeadlessTask('LiveActivityBackgroundTask', () => async (taskData) => {
360
+ react_native_1.AppRegistry.registerHeadlessTask('LiveActivityBackgroundTask', () => async (taskData) => {
339
361
  const actionId = taskData?.actionId || '';
340
362
  const activityId = taskData?.activityId || '';
341
363
  if (handler) {
342
364
  await handler(actionId, activityId);
343
365
  }
344
- const registered = actionHandlers.get(actionId);
366
+ const registered = dispatcher_1.actionHandlers.get(actionId);
345
367
  if (registered) {
346
368
  await registered({ actionId, activityId });
347
369
  }
348
- for (const globalHandler of globalActionHandlers) {
370
+ for (const globalHandler of dispatcher_1.globalActionHandlers) {
349
371
  try {
350
372
  await globalHandler(actionId, { actionId, activityId });
351
373
  }
@@ -362,7 +384,7 @@ export const LiveActivity = {
362
384
  },
363
385
  };
364
386
  // ─── 2. HOME SCREEN WIDGETS ──────────────────────────────────────────────────
365
- export const Widget = {
387
+ exports.Widget = {
366
388
  /**
367
389
  * 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
390
  */
@@ -416,13 +438,13 @@ export const Widget = {
416
438
  const convertIfJsx = (node) => {
417
439
  if (!node)
418
440
  return node;
419
- if (React.isValidElement(node) || node?.$$typeof || typeof node?.type === 'function') {
420
- return renderToWidget(node);
441
+ if (react_1.default.isValidElement(node) || node?.$$typeof || typeof node?.type === 'function') {
442
+ return (0, jsx_1.renderToWidget)(node);
421
443
  }
422
444
  return node;
423
445
  };
424
- if (React.isValidElement(finalLayout) || finalLayout?.$$typeof || typeof finalLayout?.type === 'function') {
425
- finalLayout = { medium: renderToWidget(finalLayout) };
446
+ if (react_1.default.isValidElement(finalLayout) || finalLayout?.$$typeof || typeof finalLayout?.type === 'function') {
447
+ finalLayout = { medium: (0, jsx_1.renderToWidget)(finalLayout) };
426
448
  }
427
449
  else if (finalLayout && typeof finalLayout === 'object') {
428
450
  const c = { ...finalLayout };
@@ -434,10 +456,10 @@ export const Widget = {
434
456
  c.accessoryInline = convertIfJsx(c.accessoryInline);
435
457
  finalLayout = c;
436
458
  }
437
- const saved = await SharedStorage.set(`widget_layout_${widgetKey}`, finalLayout, appGroup);
459
+ const saved = await exports.SharedStorage.set(`widget_layout_${widgetKey}`, finalLayout, appGroup);
438
460
  if (!saved)
439
461
  return false;
440
- return await Widget.reloadAll();
462
+ return await exports.Widget.reloadAll();
441
463
  }
442
464
  catch (error) {
443
465
  console.warn('[react-native-live-widgets] setLayout error:', error);
@@ -448,7 +470,7 @@ export const Widget = {
448
470
  * Cập nhật layout động cho Widget (Alias tiện ích cho `Widget.setLayout`).
449
471
  */
450
472
  update: async (widgetKeyOrConfig, layoutConfigOrAppGroup, maybeAppGroup) => {
451
- return Widget.setLayout(widgetKeyOrConfig, layoutConfigOrAppGroup, maybeAppGroup);
473
+ return exports.Widget.setLayout(widgetKeyOrConfig, layoutConfigOrAppGroup, maybeAppGroup);
452
474
  },
453
475
  /**
454
476
  * Thiết lập dòng thời gian tự động (Timeline Entries) cho Widget.
@@ -476,10 +498,10 @@ export const Widget = {
476
498
  : timelineConfig.afterDate
477
499
  : undefined,
478
500
  };
479
- const saved = await SharedStorage.set(`widget_timeline_${widgetKey}`, formattedConfig, appGroup);
501
+ const saved = await exports.SharedStorage.set(`widget_timeline_${widgetKey}`, formattedConfig, appGroup);
480
502
  if (!saved)
481
503
  return false;
482
- return await Widget.reloadAll();
504
+ return await exports.Widget.reloadAll();
483
505
  }
484
506
  catch (error) {
485
507
  console.warn('[react-native-live-widgets] setTimeline error:', error);
@@ -491,20 +513,20 @@ export const Widget = {
491
513
  * 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
514
  */
493
515
  setConfigurationOptions: async (widgetKey, options, appGroup) => {
494
- return await SharedStorage.set(`widget_config_options_${widgetKey}`, options, appGroup);
516
+ return await exports.SharedStorage.set(`widget_config_options_${widgetKey}`, options, appGroup);
495
517
  },
496
518
  /**
497
519
  * Lấy ID tùy chọn cấu hình đang được người dùng chọn ghim trên Widget.
498
520
  */
499
521
  getSelectedConfiguration: async (widgetKey, appGroup) => {
500
- return await SharedStorage.get(`widget_selected_config_${widgetKey}`, appGroup);
522
+ return await exports.SharedStorage.get(`widget_selected_config_${widgetKey}`, appGroup);
501
523
  },
502
524
  /**
503
525
  * Thiết lập lựa chọn cấu hình cho Widget từ trong ứng dụng.
504
526
  */
505
527
  setSelectedConfiguration: async (widgetKey, selectedId, appGroup) => {
506
- const ok = await SharedStorage.set(`widget_selected_config_${widgetKey}`, selectedId, appGroup);
507
- await Widget.reloadAll();
528
+ const ok = await exports.SharedStorage.set(`widget_selected_config_${widgetKey}`, selectedId, appGroup);
529
+ await exports.Widget.reloadAll();
508
530
  return ok;
509
531
  },
510
532
  /**
@@ -536,10 +558,10 @@ export const Widget = {
536
558
  else if (remoteConfig.refreshIntervalMinutes !== undefined && remoteConfig.intervalMinutes === undefined) {
537
559
  remoteConfig.intervalMinutes = remoteConfig.refreshIntervalMinutes;
538
560
  }
539
- const saved = await SharedStorage.set(`widget_remote_config_${widgetKey}`, remoteConfig, appGroup);
561
+ const saved = await exports.SharedStorage.set(`widget_remote_config_${widgetKey}`, remoteConfig, appGroup);
540
562
  if (!saved)
541
563
  return false;
542
- return await Widget.reloadAll();
564
+ return await exports.Widget.reloadAll();
543
565
  }
544
566
  catch (error) {
545
567
  console.warn('[react-native-live-widgets] setRemoteConfig error:', error);
@@ -547,11 +569,11 @@ export const Widget = {
547
569
  }
548
570
  },
549
571
  /** Đăng ký lắng nghe tương tác nút bấm từ Widget theo `actionId` */
550
- registerAction: registerAction,
572
+ registerAction: dispatcher_1.registerAction,
551
573
  /** Đă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,
574
+ onWidgetAction: dispatcher_1.registerActionHandler,
553
575
  /** Đă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,
576
+ registerActionHandler: dispatcher_1.registerActionHandler,
555
577
  /**
556
578
  * (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
579
  * 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 +602,58 @@ export const Widget = {
580
602
  return false;
581
603
  }
582
604
  },
605
+ /**
606
+ * 📊 Bảng tra cứu năng lực nền tảng (Platform Capability & Fallback Matrix).
607
+ * 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.
608
+ */
609
+ getCapabilities: async () => {
610
+ const isIOS = react_native_1.Platform.OS === 'ios';
611
+ const isAndroid = react_native_1.Platform.OS === 'android';
612
+ const osVerNum = parseFloat(String(react_native_1.Platform.Version)) || 0;
613
+ let hasIsland = false;
614
+ if (isIOS) {
615
+ try {
616
+ hasIsland = LiveActivityModule?.isDynamicIslandSupported
617
+ ? await LiveActivityModule.isDynamicIslandSupported()
618
+ : osVerNum >= 16.1;
619
+ }
620
+ catch {
621
+ hasIsland = osVerNum >= 16.1;
622
+ }
623
+ }
624
+ return {
625
+ platform: isIOS ? 'ios' : 'android',
626
+ osVersion: react_native_1.Platform.Version,
627
+ supportsLiveActivities: isIOS ? osVerNum >= 16.1 : osVerNum >= 26,
628
+ supportsDynamicIsland: hasIsland,
629
+ supportsAndroidLiveUpdates: isAndroid && osVerNum >= 36,
630
+ supportsHomeWidgets: isIOS ? osVerNum >= 14.0 : osVerNum >= 26,
631
+ supportsInteractiveIntents: isIOS ? osVerNum >= 17.0 : true,
632
+ supportsGradients: true,
633
+ supportsShadows: true,
634
+ supportsDashedBorders: true,
635
+ supportsDynamicType: true,
636
+ supportsRTL: true,
637
+ supportsTintedMode: isIOS ? osVerNum >= 18.0 : isAndroid,
638
+ supportsNumericAnimation: isIOS && osVerNum >= 16.0,
639
+ supportsAccessibility: true,
640
+ };
641
+ },
642
+ /**
643
+ * 🌲 Biên dịch cây DSL sang UI Intermediate Representation (IR & Semantic Tree - Phase 2).
644
+ */
645
+ compileIR: (layout) => {
646
+ return (0, ir_1.compileToIR)(layout);
647
+ },
648
+ /**
649
+ * 🔍 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.
650
+ */
651
+ inspectIR: (layout) => {
652
+ return (0, ir_1.inspectIR)(layout);
653
+ },
583
654
  };
584
655
  // ─── 3. SHARED STORAGE (App Groups & SharedPreferences) ─────────────────────
585
- export const SharedStorage = {
656
+ exports.SharedStorage = {
586
657
  /**
587
658
  * Lưu dữ liệu vào App Group (iOS) hoặc SharedPreferences (Android) để Widget đọc.
588
659
  */
@@ -649,7 +720,7 @@ export const SharedStorage = {
649
720
  }
650
721
  },
651
722
  };
652
- export const AudioPlayer = {
723
+ exports.AudioPlayer = {
653
724
  /**
654
725
  * Phát nhạc trực tiếp từ URL (hỗ trợ stream mp3, m4a, aac, wav...)
655
726
  * và đăng ký hệ thống Now Playing của iOS (hiện trên Dynamic Island & Lock Screen như Spotify).
@@ -722,7 +793,10 @@ export const AudioPlayer = {
722
793
  }
723
794
  },
724
795
  };
725
- export * from './types';
726
- export * from './builder';
727
- export { StyleSheet } from './builder';
796
+ __exportStar(require("./types"), exports);
797
+ __exportStar(require("./builder"), exports);
798
+ __exportStar(require("./ir"), exports);
799
+ var builder_1 = require("./builder");
800
+ Object.defineProperty(exports, "StyleSheet", { enumerable: true, get: function () { return builder_1.StyleSheet; } });
801
+ __exportStar(require("./hooks"), exports);
728
802
  //# sourceMappingURL=index.js.map