react-native-live-widgets 1.1.1 → 1.2.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.
Files changed (46) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/README.md +73 -9
  3. package/android/src/main/java/com/reactnativeliveactivity/bridge/LiveActivityModule.kt +5 -1
  4. package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetStateStore.kt +5 -1
  5. package/docs/GUIDE-EN.md +91 -7
  6. package/docs/GUIDE-VI.md +91 -7
  7. package/docs/index.html +37 -2
  8. package/docs/llms-full.txt +20 -6
  9. package/docs/llms.txt +29 -7
  10. package/ios/Models/DynamicLayoutModels.swift +5 -0
  11. package/ios/Widgets/DynamicHomeScreenWidget.swift +2 -3
  12. package/lib/builder.d.ts.map +1 -1
  13. package/lib/builder.js +29 -19
  14. package/lib/builder.js.map +1 -1
  15. package/lib/dispatcher.d.ts +7 -0
  16. package/lib/dispatcher.d.ts.map +1 -1
  17. package/lib/dispatcher.js +11 -0
  18. package/lib/dispatcher.js.map +1 -1
  19. package/lib/hooks.d.ts +66 -0
  20. package/lib/hooks.d.ts.map +1 -0
  21. package/lib/hooks.js +166 -0
  22. package/lib/hooks.js.map +1 -0
  23. package/lib/index.d.ts +32 -7
  24. package/lib/index.d.ts.map +1 -1
  25. package/lib/index.js +115 -8
  26. package/lib/index.js.map +1 -1
  27. package/lib/jsx.d.ts +79 -0
  28. package/lib/jsx.d.ts.map +1 -0
  29. package/lib/jsx.js +196 -0
  30. package/lib/jsx.js.map +1 -0
  31. package/lib/preview.d.ts +54 -0
  32. package/lib/preview.d.ts.map +1 -0
  33. package/lib/preview.js +466 -0
  34. package/lib/preview.js.map +1 -0
  35. package/lib/types.d.ts +8 -0
  36. package/lib/types.d.ts.map +1 -1
  37. package/package.json +2 -1
  38. package/src/builder.ts +29 -19
  39. package/src/dispatcher.ts +17 -0
  40. package/src/hooks.ts +223 -0
  41. package/src/index.ts +137 -13
  42. package/src/jsx.tsx +296 -0
  43. package/src/preview.tsx +719 -0
  44. package/src/react-ambient.d.ts +10 -0
  45. package/src/react-native-env.d.ts +43 -0
  46. package/src/types.ts +8 -0
package/lib/builder.js CHANGED
@@ -27,6 +27,15 @@ export const StyleSheet = {
27
27
  function isLayoutNode(item) {
28
28
  return item && typeof item === 'object' && typeof item.type === 'string';
29
29
  }
30
+ function normalizeProps(props) {
31
+ if (!props)
32
+ return undefined;
33
+ const p = { ...props };
34
+ if (p.cornerRadius !== undefined && p.borderRadius === undefined) {
35
+ p.borderRadius = p.cornerRadius;
36
+ }
37
+ return p;
38
+ }
30
39
  function parseContainerArgs(first, rest) {
31
40
  if (!first) {
32
41
  return { props: undefined, children: [] };
@@ -36,12 +45,12 @@ function parseContainerArgs(first, rest) {
36
45
  return { props: undefined, children: first };
37
46
  }
38
47
  const flattened = flattenStyle(first);
39
- return { props: flattened, children: rest || [] };
48
+ return { props: normalizeProps(flattened), children: rest || [] };
40
49
  }
41
50
  if (isLayoutNode(first)) {
42
51
  return { props: undefined, children: [first, ...(rest || [])] };
43
52
  }
44
- return { props: first, children: rest || [] };
53
+ return { props: normalizeProps(first), children: rest || [] };
45
54
  }
46
55
  /**
47
56
  * Các hàm helper tạo node cây giao diện trực quan cho TypeScript/JavaScript
@@ -86,15 +95,15 @@ export const UI = {
86
95
  if (typeof valueOrOptions === 'number') {
87
96
  return {
88
97
  type: 'Progress',
89
- props: {
98
+ props: normalizeProps({
90
99
  value: valueOrOptions,
91
100
  ...options,
92
- },
101
+ }),
93
102
  };
94
103
  }
95
104
  return {
96
105
  type: 'Progress',
97
- props: valueOrOptions,
106
+ props: normalizeProps(valueOrOptions),
98
107
  };
99
108
  },
100
109
  Image: (urlOrOptions, options) => {
@@ -103,19 +112,19 @@ export const UI = {
103
112
  const isBase64 = urlOrOptions.startsWith('data:image/');
104
113
  return {
105
114
  type: 'Image',
106
- props: {
115
+ props: normalizeProps({
107
116
  ...(isHttp
108
117
  ? { url: urlOrOptions }
109
118
  : isBase64
110
119
  ? { base64: urlOrOptions }
111
120
  : { systemName: urlOrOptions }),
112
121
  ...options,
113
- },
122
+ }),
114
123
  };
115
124
  }
116
125
  return {
117
126
  type: 'Image',
118
- props: urlOrOptions,
127
+ props: normalizeProps(urlOrOptions),
119
128
  };
120
129
  },
121
130
  Spacer: (minLength) => ({
@@ -124,17 +133,18 @@ export const UI = {
124
133
  }),
125
134
  Button: (titleOrProps, options) => {
126
135
  if (typeof titleOrProps === 'object' && titleOrProps !== null) {
127
- if (titleOrProps.onPress && !titleOrProps.actionId) {
136
+ const normalized = normalizeProps(titleOrProps);
137
+ if (normalized.onPress && !normalized.actionId) {
128
138
  autoActionCounter += 1;
129
- titleOrProps.actionId = `act_${Date.now()}_${autoActionCounter}`;
130
- registerAction(titleOrProps.actionId, titleOrProps.onPress);
139
+ normalized.actionId = `act_${Date.now()}_${autoActionCounter}`;
140
+ registerAction(normalized.actionId, normalized.onPress);
131
141
  }
132
- else if (titleOrProps.onPress && titleOrProps.actionId) {
133
- registerAction(titleOrProps.actionId, titleOrProps.onPress);
142
+ else if (normalized.onPress && normalized.actionId) {
143
+ registerAction(normalized.actionId, normalized.onPress);
134
144
  }
135
145
  return {
136
146
  type: 'Button',
137
- props: titleOrProps,
147
+ props: normalized,
138
148
  };
139
149
  }
140
150
  let finalActionId = options?.actionId;
@@ -147,11 +157,11 @@ export const UI = {
147
157
  }
148
158
  return {
149
159
  type: 'Button',
150
- props: {
160
+ props: normalizeProps({
151
161
  title: titleOrProps,
152
162
  ...options,
153
163
  actionId: finalActionId,
154
- },
164
+ }),
155
165
  };
156
166
  },
157
167
  /**
@@ -242,15 +252,15 @@ export const UI = {
242
252
  if (typeof textOrOptions === 'string') {
243
253
  return {
244
254
  type: 'Badge',
245
- props: {
255
+ props: normalizeProps({
246
256
  text: textOrOptions,
247
257
  ...options,
248
- },
258
+ }),
249
259
  };
250
260
  }
251
261
  return {
252
262
  type: 'Badge',
253
- props: textOrOptions,
263
+ props: normalizeProps(textOrOptions),
254
264
  };
255
265
  },
256
266
  Link: (props, ...children) => ({
@@ -1 +1 @@
1
- {"version":3,"file":"builder.js","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"builder.js","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"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"}
@@ -3,12 +3,19 @@ export type ActionHandler = (event: {
3
3
  activityId?: string;
4
4
  [key: string]: any;
5
5
  }) => Promise<any> | any;
6
+ export type GlobalActionHandler = (actionId: string, payload?: any) => Promise<any> | any;
6
7
  export declare const actionHandlers: Map<string, ActionHandler>;
8
+ export declare const globalActionHandlers: Set<GlobalActionHandler>;
7
9
  /**
8
10
  * Đăng ký một hàm xử lý logic TypeScript khi người dùng bấm nút có `actionId` tương ứng ngoài Widget/Live Activity.
9
11
  * Trả về hàm hủy đăng ký (unsubscribe).
10
12
  */
11
13
  export declare function registerAction(actionId: string, handler: ActionHandler): () => void;
14
+ /**
15
+ * Đăng ký hàm lắng nghe toàn bộ các sự kiện bấm nút từ Widget hoặc Live Activity.
16
+ * Trả về hàm hủy đăng ký (unsubscribe).
17
+ */
18
+ export declare function registerActionHandler(handler: GlobalActionHandler): () => void;
12
19
  /**
13
20
  * Hủy đăng ký action handler.
14
21
  */
@@ -1 +1 @@
1
- {"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../src/dispatcher.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;AAEzB,eAAO,MAAM,cAAc,4BAAmC,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,IAAI,CAKnF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEvD"}
1
+ {"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../src/dispatcher.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;AAEzB,MAAM,MAAM,mBAAmB,GAAG,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,GAAG,KACV,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;AAExB,eAAO,MAAM,cAAc,4BAAmC,CAAC;AAC/D,eAAO,MAAM,oBAAoB,0BAAiC,CAAC;AAEnE;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,IAAI,CAKnF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,IAAI,CAK9E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEvD"}
package/lib/dispatcher.js CHANGED
@@ -1,4 +1,5 @@
1
1
  export const actionHandlers = new Map();
2
+ export const globalActionHandlers = new Set();
2
3
  /**
3
4
  * Đăng ký một hàm xử lý logic TypeScript khi người dùng bấm nút có `actionId` tương ứng ngoài Widget/Live Activity.
4
5
  * Trả về hàm hủy đăng ký (unsubscribe).
@@ -9,6 +10,16 @@ export function registerAction(actionId, handler) {
9
10
  actionHandlers.delete(actionId);
10
11
  };
11
12
  }
13
+ /**
14
+ * Đăng ký hàm lắng nghe toàn bộ các sự kiện bấm nút từ Widget hoặc Live Activity.
15
+ * Trả về hàm hủy đăng ký (unsubscribe).
16
+ */
17
+ export function registerActionHandler(handler) {
18
+ globalActionHandlers.add(handler);
19
+ return () => {
20
+ globalActionHandlers.delete(handler);
21
+ };
22
+ }
12
23
  /**
13
24
  * Hủy đăng ký action handler.
14
25
  */
@@ -1 +1 @@
1
- {"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../src/dispatcher.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAyB,CAAC;AAE/D;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,OAAsB;IACrE,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,GAAG,EAAE;QACV,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC"}
1
+ {"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../src/dispatcher.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAyB,CAAC;AAC/D,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAuB,CAAC;AAEnE;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,OAAsB;IACrE,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,GAAG,EAAE;QACV,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA4B;IAChE,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,GAAG,EAAE;QACV,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC"}
package/lib/hooks.d.ts ADDED
@@ -0,0 +1,66 @@
1
+ import { ActionHandler, GlobalActionHandler } from './dispatcher';
2
+ import { LiveActivityPushTokens, StartActivityOptions, UpdateActivityOptions, EndActivityOptions } from './types';
3
+ /**
4
+ * 🎣 React Hook an toàn tuyệt đối với Fast Refresh / Hot Reloading để lắng nghe
5
+ * tương tác nút bấm trên Home Screen Widget hoặc Live Activity.
6
+ * Tự động đăng ký khi mount và hủy dọn dẹp (cleanup) khi Component unmount.
7
+ *
8
+ * Cách dùng 1 (Lắng nghe 1 actionId cụ thể):
9
+ * ```typescript
10
+ * useWidgetAction('counter:inc', (event) => {
11
+ * setCount((prev) => prev + 1);
12
+ * });
13
+ * ```
14
+ *
15
+ * Cách dùng 2 (Lắng nghe toàn cục mọi sự kiện nút bấm):
16
+ * ```typescript
17
+ * useWidgetAction((actionId, payload) => {
18
+ * console.log('Action received:', actionId, payload);
19
+ * });
20
+ * ```
21
+ */
22
+ export declare function useWidgetAction(actionIdOrCallback: string | GlobalActionHandler, handler?: ActionHandler): void;
23
+ export interface UseLiveActivityResult {
24
+ /** ID định danh phiên Live Activity hiện tại */
25
+ activityId: string | null;
26
+ /** Trạng thái phiên có đang hoạt động hay không */
27
+ isActive: boolean;
28
+ /** Token cập nhật tiện ích (iOS activityUpdateToken hoặc devicePushToken) */
29
+ pushToken: string | null;
30
+ /** Toàn bộ bộ 3 loại Push Token (deviceToken, pushToStart, activityUpdateToken) */
31
+ pushTokens: LiveActivityPushTokens | null;
32
+ /** Bắt đầu một Live Activity mới */
33
+ start: (options: StartActivityOptions) => Promise<string | null>;
34
+ /** Cập nhật nội dung Live Activity hiện tại */
35
+ update: (options: Omit<UpdateActivityOptions, 'activityId'>) => Promise<boolean>;
36
+ /** Kết thúc Live Activity hiện tại */
37
+ end: (options?: EndActivityOptions) => Promise<boolean>;
38
+ }
39
+ /**
40
+ * 🎣 React Hook quản lý vòng đời trọn vẹn của một Live Activity / Android Ongoing Notification.
41
+ * Tương thích Fast Refresh và tự động dọn dẹp state khi component unmount.
42
+ *
43
+ * ```typescript
44
+ * const { activityId, isActive, start, update, end } = useLiveActivity();
45
+ *
46
+ * // Bắt đầu khi bấm nút
47
+ * await start({
48
+ * activityId: 'order_123',
49
+ * lockScreen: UI.VStack(...)
50
+ * });
51
+ * ```
52
+ */
53
+ export declare function useLiveActivity(initialActivityId?: string): UseLiveActivityResult;
54
+ /**
55
+ * 🎣 React Hook liên kết state ứng dụng với Shared Storage của Home Screen Widget.
56
+ * Mỗi khi gọi `setWidgetState(...)`, widget sẽ tự động được hệ điều hành vẽ lại ngay lập tức.
57
+ *
58
+ * ```typescript
59
+ * const [counter, setCounter] = useWidgetState('counter_key', 0);
60
+ *
61
+ * // Cập nhật state + tự động yêu cầu Widget reload:
62
+ * setCounter(prev => prev + 1);
63
+ * ```
64
+ */
65
+ export declare function useWidgetState<T>(key: string, initialValue: T, appGroup?: string): [T, (newValue: T | ((prev: T) => T)) => Promise<void>, () => Promise<void>];
66
+ //# sourceMappingURL=hooks.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AACA,OAAO,EACL,aAAa,EACb,mBAAmB,EAGpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAC7B,kBAAkB,EAAE,MAAM,GAAG,mBAAmB,EAChD,OAAO,CAAC,EAAE,aAAa,GACtB,IAAI,CAwBN;AAED,MAAM,WAAW,qBAAqB;IACpC,gDAAgD;IAChD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,EAAE,OAAO,CAAC;IAClB,6EAA6E;IAC7E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mFAAmF;IACnF,UAAU,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC1C,oCAAoC;IACpC,KAAK,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACjE,+CAA+C;IAC/C,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjF,sCAAsC;IACtC,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACzD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,qBAAqB,CAsEjF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,CAAC,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAyC7E"}
package/lib/hooks.js ADDED
@@ -0,0 +1,166 @@
1
+ import { useState, useEffect, useRef, useCallback } from 'react';
2
+ import { registerAction, registerActionHandler, } from './dispatcher';
3
+ import { LiveActivity, SharedStorage, Widget } from './index';
4
+ /**
5
+ * 🎣 React Hook an toàn tuyệt đối với Fast Refresh / Hot Reloading để lắng nghe
6
+ * tương tác nút bấm trên Home Screen Widget hoặc Live Activity.
7
+ * Tự động đăng ký khi mount và hủy dọn dẹp (cleanup) khi Component unmount.
8
+ *
9
+ * Cách dùng 1 (Lắng nghe 1 actionId cụ thể):
10
+ * ```typescript
11
+ * useWidgetAction('counter:inc', (event) => {
12
+ * setCount((prev) => prev + 1);
13
+ * });
14
+ * ```
15
+ *
16
+ * Cách dùng 2 (Lắng nghe toàn cục mọi sự kiện nút bấm):
17
+ * ```typescript
18
+ * useWidgetAction((actionId, payload) => {
19
+ * console.log('Action received:', actionId, payload);
20
+ * });
21
+ * ```
22
+ */
23
+ export function useWidgetAction(actionIdOrCallback, handler) {
24
+ const savedHandler = useRef(undefined);
25
+ useEffect(() => {
26
+ savedHandler.current = typeof actionIdOrCallback === 'function' ? actionIdOrCallback : handler;
27
+ });
28
+ useEffect(() => {
29
+ if (typeof actionIdOrCallback === 'function') {
30
+ const unsubscribe = registerActionHandler((actionId, payload) => {
31
+ if (typeof savedHandler.current === 'function') {
32
+ savedHandler.current(actionId, payload);
33
+ }
34
+ });
35
+ return unsubscribe;
36
+ }
37
+ else if (typeof actionIdOrCallback === 'string') {
38
+ const unsubscribe = registerAction(actionIdOrCallback, (event) => {
39
+ if (typeof savedHandler.current === 'function') {
40
+ savedHandler.current(event);
41
+ }
42
+ });
43
+ return unsubscribe;
44
+ }
45
+ }, [actionIdOrCallback]);
46
+ }
47
+ /**
48
+ * 🎣 React Hook quản lý vòng đời trọn vẹn của một Live Activity / Android Ongoing Notification.
49
+ * Tương thích Fast Refresh và tự động dọn dẹp state khi component unmount.
50
+ *
51
+ * ```typescript
52
+ * const { activityId, isActive, start, update, end } = useLiveActivity();
53
+ *
54
+ * // Bắt đầu khi bấm nút
55
+ * await start({
56
+ * activityId: 'order_123',
57
+ * lockScreen: UI.VStack(...)
58
+ * });
59
+ * ```
60
+ */
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
+ let mounted = true;
67
+ if (currentId) {
68
+ LiveActivity.getAllPushTokens(currentId)
69
+ .then((tokens) => {
70
+ if (mounted && tokens) {
71
+ setPushTokens(tokens);
72
+ }
73
+ })
74
+ .catch(() => { });
75
+ }
76
+ return () => {
77
+ mounted = false;
78
+ };
79
+ }, [currentId]);
80
+ const start = useCallback(async (options) => {
81
+ const ok = await LiveActivity.start(options);
82
+ if (ok) {
83
+ setCurrentId(options.activityId);
84
+ setIsActive(true);
85
+ try {
86
+ const tokens = await LiveActivity.getAllPushTokens(options.activityId);
87
+ setPushTokens(tokens);
88
+ }
89
+ catch (_) { }
90
+ return options.activityId;
91
+ }
92
+ return null;
93
+ }, []);
94
+ const update = useCallback(async (options) => {
95
+ if (!currentId)
96
+ return false;
97
+ return await LiveActivity.update({
98
+ activityId: currentId,
99
+ ...options,
100
+ });
101
+ }, [currentId]);
102
+ const end = useCallback(async (options) => {
103
+ if (!currentId)
104
+ return false;
105
+ const ok = await LiveActivity.end(currentId, options);
106
+ if (ok) {
107
+ setIsActive(false);
108
+ }
109
+ return ok;
110
+ }, [currentId]);
111
+ return {
112
+ activityId: currentId,
113
+ isActive,
114
+ pushToken: pushTokens?.activityUpdateToken || pushTokens?.devicePushToken || null,
115
+ pushTokens,
116
+ start,
117
+ update,
118
+ end,
119
+ };
120
+ }
121
+ /**
122
+ * 🎣 React Hook liên kết state ứng dụng với Shared Storage của Home Screen Widget.
123
+ * Mỗi khi gọi `setWidgetState(...)`, widget sẽ tự động được hệ điều hành vẽ lại ngay lập tức.
124
+ *
125
+ * ```typescript
126
+ * const [counter, setCounter] = useWidgetState('counter_key', 0);
127
+ *
128
+ * // Cập nhật state + tự động yêu cầu Widget reload:
129
+ * setCounter(prev => prev + 1);
130
+ * ```
131
+ */
132
+ export function useWidgetState(key, initialValue, appGroup) {
133
+ const [state, setState] = useState(initialValue);
134
+ useEffect(() => {
135
+ let mounted = true;
136
+ SharedStorage.get(key, appGroup)
137
+ .then((val) => {
138
+ if (mounted && val !== null && val !== undefined) {
139
+ setState(val);
140
+ }
141
+ })
142
+ .catch(() => { });
143
+ return () => {
144
+ mounted = false;
145
+ };
146
+ }, [key, appGroup]);
147
+ const setWidgetState = useCallback(async (newValue) => {
148
+ setState((prev) => {
149
+ const resolved = typeof newValue === 'function' ? newValue(prev) : newValue;
150
+ SharedStorage.set(key, resolved, appGroup)
151
+ .then(() => {
152
+ Widget.reloadAll().catch(() => { });
153
+ })
154
+ .catch(() => { });
155
+ return resolved;
156
+ });
157
+ }, [key, appGroup]);
158
+ const reload = useCallback(async () => {
159
+ const val = await SharedStorage.get(key, appGroup);
160
+ if (val !== null && val !== undefined) {
161
+ setState(val);
162
+ }
163
+ }, [key, appGroup]);
164
+ return [state, setWidgetState, reload];
165
+ }
166
+ //# sourceMappingURL=hooks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}
package/lib/index.d.ts CHANGED
@@ -1,7 +1,10 @@
1
1
  import { ActiveActivityInfo, EndActivityOptions, LiveActivityPushTokens, StartActivityOptions, UpdateActivityOptions, WidgetConfigOption, WidgetLayoutConfig, WidgetRemoteConfig, WidgetTimelineConfig } from './types';
2
- import { ActionHandler, registerAction, unregisterAction } from './dispatcher';
3
- export type { ActionHandler };
4
- export { registerAction, unregisterAction };
2
+ import { ActionHandler, GlobalActionHandler, registerAction, registerActionHandler, unregisterAction } from './dispatcher';
3
+ export type { ActionHandler, GlobalActionHandler };
4
+ export { registerAction, registerActionHandler, unregisterAction };
5
+ export * from './hooks';
6
+ export * from './jsx';
7
+ export * from './preview';
5
8
  export declare const LiveActivity: {
6
9
  /**
7
10
  * Khởi động một Live Activity (iOS) hoặc Live Update / Ongoing Notification (Android).
@@ -61,6 +64,11 @@ export declare const LiveActivity: {
61
64
  * Trả về hàm hủy đăng ký (unsubscribe).
62
65
  */
63
66
  registerAction: (actionId: string, handler: ActionHandler) => (() => void);
67
+ /**
68
+ * Đăng ký hàm lắng nghe toàn cục tất cả các sự kiện bấm nút từ Live Activity hoặc Widget.
69
+ * Nhận `(actionId, payload)`. Trả về hàm hủy đăng ký (unsubscribe).
70
+ */
71
+ registerActionHandler: (handler: GlobalActionHandler) => (() => void);
64
72
  /**
65
73
  * Hủy đăng ký action handler theo `actionId`.
66
74
  */
@@ -103,9 +111,16 @@ export declare const Widget: {
103
111
  reload: (kind: string) => Promise<boolean>;
104
112
  /**
105
113
  * Thiết lập layout động cho Home Screen Widget (hỗ trợ small, medium, large).
106
- * Tự động lưu vào Shared Storage và yêu cầu vẽ lại.
114
+ * Hỗ trợ gọi 2 hoặc 3 tham số:
115
+ * - `Widget.setLayout('main', layoutConfig, appGroup?)`
116
+ * - `Widget.setLayout(layoutConfig, appGroup?)` (tự động gán widgetKey = 'main')
117
+ * Tự động lưu vào Shared Storage và yêu cầu OS vẽ lại.
107
118
  */
108
- setLayout: (widgetKey: string, layoutConfig: WidgetLayoutConfig, appGroup?: string) => Promise<boolean>;
119
+ setLayout: (widgetKeyOrConfig: string | WidgetLayoutConfig, layoutConfigOrAppGroup?: WidgetLayoutConfig | string, maybeAppGroup?: string) => Promise<boolean>;
120
+ /**
121
+ * Cập nhật layout động cho Widget (Alias tiện ích cho `Widget.setLayout`).
122
+ */
123
+ update: (widgetKeyOrConfig: string | WidgetLayoutConfig, layoutConfigOrAppGroup?: WidgetLayoutConfig | string, maybeAppGroup?: string) => Promise<boolean>;
109
124
  /**
110
125
  * Thiết lập dòng thời gian tự động (Timeline Entries) cho Widget.
111
126
  * Hệ điều hành iOS/Android sẽ tự động chuyển đổi giữa các layout theo từng mốc thời gian
@@ -129,8 +144,18 @@ export declare const Widget: {
129
144
  * Cấu hình Endpoint API để bản thân Widget Extension tự chạy ngầm lấy dữ liệu mới
130
145
  * theo chu kỳ (`getTimeline`) hoặc khi bấm nút `actionId: 'refresh'` trên mặt Widget,
131
146
  * kể cả khi người dùng đã vuốt tắt (Kill) hoàn toàn ứng dụng chính!
132
- */
133
- setRemoteConfig: (widgetKey: string, remoteConfig: WidgetRemoteConfig, appGroup?: string) => Promise<boolean>;
147
+ *
148
+ * Hỗ trợ gọi linh hoạt:
149
+ * - `Widget.setRemoteConfig('main', { url, refreshIntervalMinutes }, appGroup?)`
150
+ * - `Widget.setRemoteConfig({ url, intervalMinutes }, appGroup?)` (tự động gán widgetKey = 'main')
151
+ */
152
+ setRemoteConfig: (widgetKeyOrConfig: string | WidgetRemoteConfig, remoteConfigOrAppGroup?: WidgetRemoteConfig | string, maybeAppGroup?: string) => Promise<boolean>;
153
+ /** Đăng ký lắng nghe tương tác nút bấm từ Widget theo `actionId` */
154
+ registerAction: typeof registerAction;
155
+ /** Đăng ký lắng nghe toàn cục tất cả tương tác nút bấm từ Widget (alias) */
156
+ onWidgetAction: typeof registerActionHandler;
157
+ /** Đăng ký lắng nghe toàn cục tất cả tương tác nút bấm từ Widget */
158
+ registerActionHandler: typeof registerActionHandler;
134
159
  /**
135
160
  * (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.
136
161
  * 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.
@@ -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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"}