react-native-live-widgets 1.1.0 → 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 (53) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +76 -10
  3. package/android/build.gradle +14 -20
  4. package/android/src/main/AndroidManifest.xml +1 -0
  5. package/android/src/main/java/com/reactnativeliveactivity/bridge/LiveActivityModule.kt +5 -1
  6. package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityHeadlessTaskService.kt +8 -0
  7. package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityReceiver.kt +4 -1
  8. package/android/src/main/java/com/reactnativeliveactivity/renderer/DynamicWidgetCanvasRenderer.kt +29 -3
  9. package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetStateStore.kt +26 -1
  10. package/android/src/main/java/com/reactnativeliveactivity/widgets/DynamicHomeScreenWidgetProvider.kt +51 -15
  11. package/android/src/main/res/layout/rn_live_widget_host.xml +64 -74
  12. package/docs/GUIDE-EN.md +109 -7
  13. package/docs/GUIDE-VI.md +109 -7
  14. package/docs/index.html +440 -0
  15. package/docs/llms-full.txt +132 -0
  16. package/docs/llms.txt +88 -0
  17. package/ios/Models/DynamicLayoutModels.swift +5 -0
  18. package/ios/Widgets/DynamicHomeScreenWidget.swift +2 -3
  19. package/lib/builder.d.ts.map +1 -1
  20. package/lib/builder.js +29 -19
  21. package/lib/builder.js.map +1 -1
  22. package/lib/dispatcher.d.ts +7 -0
  23. package/lib/dispatcher.d.ts.map +1 -1
  24. package/lib/dispatcher.js +11 -0
  25. package/lib/dispatcher.js.map +1 -1
  26. package/lib/hooks.d.ts +66 -0
  27. package/lib/hooks.d.ts.map +1 -0
  28. package/lib/hooks.js +166 -0
  29. package/lib/hooks.js.map +1 -0
  30. package/lib/index.d.ts +32 -7
  31. package/lib/index.d.ts.map +1 -1
  32. package/lib/index.js +115 -8
  33. package/lib/index.js.map +1 -1
  34. package/lib/jsx.d.ts +79 -0
  35. package/lib/jsx.d.ts.map +1 -0
  36. package/lib/jsx.js +196 -0
  37. package/lib/jsx.js.map +1 -0
  38. package/lib/preview.d.ts +54 -0
  39. package/lib/preview.d.ts.map +1 -0
  40. package/lib/preview.js +466 -0
  41. package/lib/preview.js.map +1 -0
  42. package/lib/types.d.ts +8 -0
  43. package/lib/types.d.ts.map +1 -1
  44. package/package.json +3 -1
  45. package/src/builder.ts +29 -19
  46. package/src/dispatcher.ts +17 -0
  47. package/src/hooks.ts +223 -0
  48. package/src/index.ts +137 -13
  49. package/src/jsx.tsx +296 -0
  50. package/src/preview.tsx +719 -0
  51. package/src/react-ambient.d.ts +10 -0
  52. package/src/react-native-env.d.ts +43 -0
  53. package/src/types.ts +8 -0
package/docs/llms.txt ADDED
@@ -0,0 +1,88 @@
1
+ # react-native-live-widgets
2
+
3
+ > The All-in-One declarative TypeScript engine for iOS Live Activities, Dynamic Island, and interactive Home Screen Widgets in React Native & Expo (iOS 16.1+ & Android 16).
4
+
5
+ Write 100% Declarative TypeScript (`UI.*`) in your React Native code. Automatically renders to native SwiftUI (WidgetKit) and Android High-DPI 2D Canvas without manually touching Xcode or Android Studio.
6
+
7
+ ## Quick Reference for LLMs & AI Agents
8
+
9
+ ### Core Modules
10
+ - `LiveActivity`: Start, update, end, and inspect lock screen Live Activities & Dynamic Island on iOS, and Promoted Live Updates (`Notification.ProgressStyle`) on Android.
11
+ - `Widget`: Set dynamic multi-page layouts (`pages`), configure background API polling (`setRemoteConfig`), trigger reload, and request in-app widget pinning (`requestPin` on Android).
12
+ - `SharedStorage`: Fast synchronous App Group (iOS) and SharedPreferences (Android) key-value bridge.
13
+ - `UI`: Declarative DSL builder (`UI.VStack`, `UI.HStack`, `UI.ZStack`, `UI.Text`, `UI.Button`, `UI.Progress`, `UI.Timer`, `UI.Equalizer`, `UI.Image`, `UI.Gauge`, `UI.Chart`).
14
+
15
+ ### Installation & Scaffolding
16
+ - **Expo (SDK 50, 51, 52, 58+)**:
17
+ ```bash
18
+ npx expo install react-native-live-widgets
19
+ # Add plugin in app.json with appGroup, enableLiveActivities
20
+ npx expo prebuild
21
+ npx react-native-live-widgets init --group group.com.yourcompany.app
22
+ ```
23
+ - **Bare React Native CLI**:
24
+ ```bash
25
+ npm install react-native-live-widgets
26
+ npx react-native-live-widgets init --group group.com.yourcompany.app
27
+ ```
28
+
29
+ ### Dual UI Authoring Syntax: JSX Components & Functional DSL
30
+ Widgets can be built with **EITHER** JSX elements or Functional DSL:
31
+ - **JSX / TSX Elements**: `<VStack>`, `<HStack>`, `<ZStack>`, `<Grid>`, `<Text>`, `<Button>`, `<Badge>`, `<Progress>`, `<Timer>`, `<Equalizer>`, `<Image>`, `<Spacer>`, `<Divider>`, `<Link>`. Fully supports `style` props, StyleSheet objects, and conditional style arrays!
32
+ - **Functional DSL**: `UI.VStack(...)`, `UI.HStack(...)`, `UI.Text(...)`, `UI.Button(...)`, etc.
33
+ - **In-App Widget Preview**: `<WidgetPreview size="medium" showBadge interactiveSizeSwitch>{jsxLayout}</WidgetPreview>` (alias: `<VoltraWidgetPreview>`).
34
+
35
+ ### Key Declarative UI DSL Methods
36
+ - `UI.VStack(options, ...children)` / `UI.HStack(options, ...children)`: Flex containers with `spacing`, `padding`, `backgroundColor`, `borderRadius`, `alignment`.
37
+ - `UI.Text(content, { color, fontSize, fontWeight: 'bold'|'heavy'|'medium'|'regular', maxLines })`
38
+ - `UI.Timer(timestampMs, { mode: 'countdown'|'timer'|'relative', color, fontSize })`: Zero-battery native hardware clock.
39
+ - `UI.Progress(options)`: Supports `style: 'bar' | 'segmented' | 'circular'`, `value` (0.0 to 1.0), `tintColor`, `trackColor`.
40
+ - `UI.Equalizer({ isPlaying: true, barCount: 4, tintColor, height })`: Realtime animated audio waveform on Dynamic Island & lock screen.
41
+ - `UI.Image({ url, base64, systemName, width, height, borderRadius, contentMode })`: Auto-cached remote images, base64 data, or SF Symbols (supports `cornerRadius` as alias).
42
+ - `UI.Button('Title', { actionId, ... })` or `UI.Button({ title, actionId, ... })`: Interactive widget button triggering `AppIntents` (iOS 17+) and `BroadcastReceiver` (Android).
43
+ - `UI.Badge('Text', { ... })` or `UI.Badge({ text, ... })`: Metric badges.
44
+ - `UI.Gauge(value, { size, tintColor, trackColor, label, valueText })`: 240° KPI circular gauge.
45
+ - `UI.Chart(dataPoints, { style: 'bar'|'line', labels, tintColor, height })`: Lightweight trend sparklines.
46
+
47
+ ### React Hooks (Fast Refresh Resilient)
48
+ ```typescript
49
+ import { useWidgetAction, useLiveActivity, useWidgetState } from 'react-native-live-widgets';
50
+
51
+ // 1. Hook: Listen to widget button interactions (safe with Fast Refresh)
52
+ useWidgetAction('INCREMENT', () => {
53
+ setCount(c => c + 1);
54
+ });
55
+
56
+ // 2. Hook: Manage Live Activity lifecycle
57
+ const { activityId, isActive, start, update, end } = useLiveActivity();
58
+
59
+ // 3. Hook: Two-way state sync with Widget SharedStorage
60
+ const [counter, setCounter] = useWidgetState('widget_counter', 0);
61
+ ```
62
+
63
+ ### Imperative Action Handling
64
+ ```typescript
65
+ import { Widget, LiveActivity } from 'react-native-live-widgets';
66
+
67
+ // Listen to widget button interactions imperatively
68
+ const unsubscribe = Widget.onWidgetAction((actionId, payload) => {
69
+ if (actionId === 'INCREMENT') {
70
+ Widget.reload('main');
71
+ }
72
+ });
73
+ ```
74
+
75
+ ### Golden Rules for AI Agents
76
+ 1. **Never write Swift or Kotlin files manually** when a declarative `UI.*` node exists.
77
+ 2. **App Groups**: Both iOS app and Widget Extension MUST share the identical App Group name (e.g. `group.<bundle_id>`).
78
+ 3. **Dynamic Island**: Always configure `compactLeading`, `compactTrailing`, `minimal`, and `expanded` (`leading`, `trailing`, `bottom`, `center`).
79
+ 4. **App Termination (Force-Kill)**: When the app is force-killed on iOS, JS runtime stops. Design mission-critical actions (like employee attendance check-ins) using native `SharedStorage` queue rather than expecting live JS callbacks while killed.
80
+ 5. **Background Sync**: `Widget.setRemoteConfig` allows native widgets to fetch fresh JSON from a REST endpoint without requiring server-side APNs push infrastructure.
81
+
82
+ ## Documentation Links
83
+ - [English Full Guide](https://github.com/React-Native-Vu/react-native-live-widgets/blob/dev/docs/GUIDE-EN.md)
84
+ - [Vietnamese Full Guide](https://github.com/React-Native-Vu/react-native-live-widgets/blob/dev/docs/GUIDE-VI.md)
85
+ - [Dedicated Expo Guide (EN)](https://github.com/React-Native-Vu/react-native-live-widgets/blob/dev/docs/EXPO-GUIDE-EN.md)
86
+ - [Dedicated Expo Guide (VI)](https://github.com/React-Native-Vu/react-native-live-widgets/blob/dev/docs/EXPO-GUIDE-VI.md)
87
+ - [Official Expo Demo Repo](https://github.com/React-Native-Vu/LiveWidgetsExampleExpo)
88
+ - [Official Bare RN Demo Repo](https://github.com/React-Native-Vu/LiveWidgetsExample)
@@ -119,6 +119,11 @@ public struct WidgetRemoteConfigDTO: Codable {
119
119
  public let method: String?
120
120
  public let headers: [String: String]?
121
121
  public let refreshIntervalMinutes: Int?
122
+ public let intervalMinutes: Int?
123
+
124
+ public var effectiveIntervalMinutes: Int {
125
+ return refreshIntervalMinutes ?? intervalMinutes ?? 15
126
+ }
122
127
  }
123
128
 
124
129
  public struct InteractiveWidgetState: Codable {
@@ -110,9 +110,8 @@ public struct DynamicWidgetProvider: TimelineProvider {
110
110
  let configKey = "widget_remote_config_\(widgetKey)"
111
111
  if let json = Self.readSharedString(forKey: configKey, appGroup: appGroup),
112
112
  let data = json.data(using: .utf8),
113
- let config = try? JSONDecoder().decode(WidgetRemoteConfigDTO.self, from: data),
114
- let mins = config.refreshIntervalMinutes, mins >= 1 {
115
- return mins
113
+ let config = try? JSONDecoder().decode(WidgetRemoteConfigDTO.self, from: data) {
114
+ return max(1, config.effectiveIntervalMinutes)
116
115
  }
117
116
  return 15
118
117
  }
@@ -1 +1 @@
1
- {"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"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"}
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":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EAGL,cAAc,EACd,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAQ9D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,eAAe,CAC7B,kBAAgD,EAChD,OAAuB;IAEvB,MAAM,YAAY,GAAG,MAAM,CAAkD,SAAS,CAAC,CAAC;IAExF,SAAS,CAAC,GAAG,EAAE;QACb,YAAY,CAAC,OAAO,GAAG,OAAO,kBAAkB,KAAK,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC;IACjG,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,kBAAkB,KAAK,UAAU,EAAE,CAAC;YAC7C,MAAM,WAAW,GAAG,qBAAqB,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE;gBAC9D,IAAI,OAAO,YAAY,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;oBAC9C,YAAY,CAAC,OAA+B,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACnE,CAAC;YACH,CAAC,CAAC,CAAC;YACH,OAAO,WAAW,CAAC;QACrB,CAAC;aAAM,IAAI,OAAO,kBAAkB,KAAK,QAAQ,EAAE,CAAC;YAClD,MAAM,WAAW,GAAG,cAAc,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC/D,IAAI,OAAO,YAAY,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;oBAC9C,YAAY,CAAC,OAAyB,CAAC,KAAK,CAAC,CAAC;gBACjD,CAAC;YACH,CAAC,CAAC,CAAC;YACH,OAAO,WAAW,CAAC;QACrB,CAAC;IACH,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC;AAC3B,CAAC;AAmBD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,iBAA0B;IACxD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAgB,iBAAiB,IAAI,IAAI,CAAC,CAAC;IACrF,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAU,CAAC,CAAC,iBAAiB,CAAC,CAAC;IACvE,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAgC,IAAI,CAAC,CAAC;IAElF,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,IAAI,SAAS,EAAE,CAAC;YACd,YAAY,CAAC,gBAAgB,CAAC,SAAS,CAAC;iBACrC,IAAI,CAAC,CAAC,MAA8B,EAAE,EAAE;gBACvC,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;oBACtB,aAAa,CAAC,MAAM,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC,CAAC;iBACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,GAAG,EAAE;YACV,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,MAAM,KAAK,GAAG,WAAW,CACvB,KAAK,EAAE,OAA6B,EAA0B,EAAE;QAC9D,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,EAAE,EAAE,CAAC;YACP,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YACjC,WAAW,CAAC,IAAI,CAAC,CAAC;YAClB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBACvE,aAAa,CAAC,MAAM,CAAC,CAAC;YACxB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC,CAAA,CAAC;YACd,OAAO,OAAO,CAAC,UAAU,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,EACD,EAAE,CACH,CAAC;IAEF,MAAM,MAAM,GAAG,WAAW,CACxB,KAAK,EAAE,OAAkD,EAAoB,EAAE;QAC7E,IAAI,CAAC,SAAS;YAAE,OAAO,KAAK,CAAC;QAC7B,OAAO,MAAM,YAAY,CAAC,MAAM,CAAC;YAC/B,UAAU,EAAE,SAAS;YACrB,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC,EACD,CAAC,SAAS,CAAC,CACZ,CAAC;IAEF,MAAM,GAAG,GAAG,WAAW,CACrB,KAAK,EAAE,OAA4B,EAAoB,EAAE;QACvD,IAAI,CAAC,SAAS;YAAE,OAAO,KAAK,CAAC;QAC7B,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACtD,IAAI,EAAE,EAAE,CAAC;YACP,WAAW,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC,EACD,CAAC,SAAS,CAAC,CACZ,CAAC;IAEF,OAAO;QACL,UAAU,EAAE,SAAS;QACrB,QAAQ;QACR,SAAS,EAAE,UAAU,EAAE,mBAAmB,IAAI,UAAU,EAAE,eAAe,IAAI,IAAI;QACjF,UAAU;QACV,KAAK;QACL,MAAM;QACN,GAAG;KACJ,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAW,EACX,YAAe,EACf,QAAiB;IAEjB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAI,YAAY,CAAC,CAAC;IAEpD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,aAAa,CAAC,GAAG,CAAI,GAAG,EAAE,QAAQ,CAAC;aAChC,IAAI,CAAC,CAAC,GAAa,EAAE,EAAE;YACtB,IAAI,OAAO,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACjD,QAAQ,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACnB,OAAO,GAAG,EAAE;YACV,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEpB,MAAM,cAAc,GAAG,WAAW,CAChC,KAAK,EAAE,QAA8B,EAAE,EAAE;QACvC,QAAQ,CAAC,CAAC,IAAO,EAAE,EAAE;YACnB,MAAM,QAAQ,GACZ,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAE,QAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC9E,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC;iBACvC,IAAI,CAAC,GAAG,EAAE;gBACT,MAAM,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACrC,CAAC,CAAC;iBACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACnB,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC,EACD,CAAC,GAAG,EAAE,QAAQ,CAAC,CAChB,CAAC;IAEF,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACpC,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,GAAG,CAAI,GAAG,EAAE,QAAQ,CAAC,CAAC;QACtD,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEpB,OAAO,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC"}