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/docs/index.html CHANGED
@@ -1,11 +1,14 @@
1
1
  <!DOCTYPE html>
2
- <html lang="vi" class="dark">
2
+ <html lang="vi" class="dark scroll-smooth">
3
3
  <head>
4
4
  <meta charset="UTF-8">
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>react-native-live-widgets — Documentation & AI Agent Hub</title>
7
- <meta name="description" content="All-in-One Declarative Engine for Live Activities, Dynamic Island & Interactive Home Screen Widgets in React Native & Expo.">
6
+ <title>react-native-live-widgets — Live Activities, Dynamic Island & Interactive Home Screen Widgets</title>
7
+ <meta name="description" content="All-in-One Declarative Engine & JSX for Live Activities, Dynamic Island and Interactive Home Screen Widgets in React Native & Expo without Swift/Kotlin.">
8
+ <link rel="canonical" href="https://react-native-vu.github.io/react-native-live-widgets/">
9
+ <meta property="og:url" content="https://react-native-vu.github.io/react-native-live-widgets/">
8
10
  <link rel="icon" href="https://raw.githubusercontent.com/React-Native-Vu/react-native-live-widgets/dev/assets/dynamic_island_expanded.png" type="image/png">
11
+
9
12
  <!-- Tailwind CSS CDN -->
10
13
  <script src="https://cdn.tailwindcss.com"></script>
11
14
  <script>
@@ -17,205 +20,539 @@
17
20
  brand: {
18
21
  50: '#F0F9FF',
19
22
  100: '#E0F2FE',
20
- 500: '#0284C7',
23
+ 400: '#38BDF8',
24
+ 500: '#0EA5E9',
21
25
  600: '#0284C7',
22
26
  700: '#0369A1',
23
27
  },
24
- darkBg: '#090D16',
25
- cardBg: '#111827',
26
- cardBorder: '#1F2937'
28
+ darkBg: '#080C14',
29
+ darkCard: '#0F1626',
30
+ cardBorder: '#1E293B',
31
+ accentGlow: 'rgba(56, 189, 248, 0.15)',
32
+ },
33
+ animation: {
34
+ 'pulse-slow': 'pulse 3s cubic-bezier(0.4, 0, 0.6, 1) infinite',
35
+ 'float': 'float 4s ease-in-out infinite',
36
+ 'glow': 'glow 3s ease-in-out infinite alternate',
37
+ },
38
+ keyframes: {
39
+ float: {
40
+ '0%, 100%': { transform: 'translateY(0px)' },
41
+ '50%': { transform: 'translateY(-6px)' },
42
+ },
43
+ glow: {
44
+ '0%': { boxShadow: '0 0 15px rgba(56, 189, 248, 0.2)' },
45
+ '100%': { boxShadow: '0 0 35px rgba(56, 189, 248, 0.45)' },
46
+ }
27
47
  }
28
48
  }
29
49
  }
30
50
  }
31
51
  </script>
52
+
32
53
  <!-- Lucide Icons -->
33
54
  <script src="https://unpkg.com/lucide@latest"></script>
55
+
34
56
  <!-- PrismJS for syntax highlighting -->
35
57
  <link href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/themes/prism-tomorrow.min.css" rel="stylesheet" />
36
58
  <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/prism.min.js"></script>
37
59
  <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-typescript.min.js"></script>
60
+ <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-jsx.min.js"></script>
61
+ <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-tsx.min.js"></script>
38
62
  <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-bash.min.js"></script>
39
63
  <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-json.min.js"></script>
64
+ <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-swift.min.js"></script>
65
+ <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-kotlin.min.js"></script>
66
+
40
67
  <style>
68
+ /* Ensure sticky header does not cover anchor targets */
69
+ html {
70
+ scroll-padding-top: 5.5rem;
71
+ }
72
+
73
+ /* Custom Scrollbar */
74
+ ::-webkit-scrollbar {
75
+ width: 6px;
76
+ height: 6px;
77
+ }
78
+ ::-webkit-scrollbar-track {
79
+ background: #080C14;
80
+ }
81
+ ::-webkit-scrollbar-thumb {
82
+ background: #1E293B;
83
+ border-radius: 9999px;
84
+ }
85
+ ::-webkit-scrollbar-thumb:hover {
86
+ background: #334155;
87
+ }
88
+
89
+ /* Prism styling overhaul */
41
90
  pre[class*="language-"] {
42
- background: #0D1117 !important;
43
- border: 1px solid #21262D;
44
- border-radius: 0.75rem;
45
- margin: 1rem 0;
46
- font-size: 0.875rem;
91
+ background: #0B111E !important;
92
+ border: 1px solid #1E293B;
93
+ border-radius: 0.85rem;
94
+ margin: 0 !important;
95
+ padding: 1.15rem !important;
96
+ font-size: 0.86rem;
97
+ line-height: 1.55;
47
98
  }
48
99
  code[class*="language-"] {
49
100
  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace;
50
101
  }
51
- .custom-scrollbar::-webkit-scrollbar {
52
- width: 6px;
102
+
103
+ /* Equalizer Sound Waves Keyframe */
104
+ @keyframes soundwave {
105
+ 0%, 100% { height: 4px; }
106
+ 50% { height: 26px; }
53
107
  }
54
- .custom-scrollbar::-webkit-scrollbar-thumb {
55
- background: #374151;
56
- border-radius: 3px;
108
+ .eq-bar-1 { animation: soundwave 0.75s ease-in-out infinite; }
109
+ .eq-bar-2 { animation: soundwave 0.55s ease-in-out infinite 0.12s; }
110
+ .eq-bar-3 { animation: soundwave 0.9s ease-in-out infinite 0.25s; }
111
+ .eq-bar-4 { animation: soundwave 0.65s ease-in-out infinite 0.08s; }
112
+ .eq-bar-5 { animation: soundwave 0.8s ease-in-out infinite 0.18s; }
113
+
114
+ /* Dynamic Island Simulator Transition */
115
+ .island-container {
116
+ transition: all 0.4s cubic-bezier(0.16, 1, 0.3, 1);
117
+ }
118
+
119
+ /* Subtle backdrop grid pattern */
120
+ .bg-grid-pattern {
121
+ background-size: 32px 32px;
122
+ background-image: linear-gradient(to right, rgba(255, 255, 255, 0.03) 1px, transparent 1px),
123
+ linear-gradient(to bottom, rgba(255, 255, 255, 0.03) 1px, transparent 1px);
57
124
  }
58
125
  </style>
59
126
  </head>
60
127
  <body class="bg-darkBg text-slate-200 min-h-screen flex flex-col font-sans antialiased selection:bg-sky-500 selection:text-white">
61
128
 
62
- <!-- Top Navigation Header -->
63
- <header class="sticky top-0 z-50 backdrop-blur-md bg-darkBg/80 border-b border-cardBorder">
129
+ <!-- Top Announcement Bar -->
130
+ <div class="bg-gradient-to-r from-sky-900/50 via-indigo-900/40 to-purple-900/50 border-b border-sky-500/20 py-2 px-4 text-center text-xs text-sky-200">
131
+ <span class="inline-flex items-center space-x-1.5 font-medium">
132
+ <span class="px-2 py-0.5 rounded-full bg-emerald-500/20 text-emerald-300 font-semibold text-[10px] uppercase tracking-wide" data-i18n="announcement_tag">Mới v1.2.1</span>
133
+ <span data-i18n="announcement_text">Exact Dynamic Hit Layer, Native Chronometer Countdown, Swift 6 Ready & Chuẩn hoá <strong>UI IR</strong></span>
134
+ <a href="#exact-hit-layer" data-i18n="announcement_link" class="underline hover:text-white ml-2">Xem chi tiết &rarr;</a>
135
+ </span>
136
+ </div>
137
+
138
+ <!-- Main Navigation Header -->
139
+ <header class="sticky top-0 z-50 backdrop-blur-xl bg-darkBg/85 border-b border-cardBorder">
64
140
  <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 h-16 flex items-center justify-between">
141
+
142
+ <!-- Brand Logo -->
65
143
  <div class="flex items-center space-x-3">
66
- <span class="text-2xl">🚀</span>
67
- <a href="#" class="font-bold text-lg text-white hover:text-sky-400 transition">
68
- react-native-live-widgets
69
- </a>
70
- <span class="inline-flex items-center px-2.5 py-0.5 rounded-full text-xs font-semibold bg-sky-500/10 text-sky-400 border border-sky-500/20">
71
- v1.1.0
72
- </span>
73
- <span class="hidden sm:inline-flex items-center px-2 py-0.5 rounded-full text-xs font-medium bg-emerald-500/10 text-emerald-400 border border-emerald-500/20">
74
- Expo Ready
144
+ <div class="w-9 h-9 rounded-xl bg-gradient-to-tr from-sky-500 to-indigo-600 flex items-center justify-center text-white shadow-lg shadow-sky-500/25">
145
+ <i data-lucide="layers" class="w-5 h-5"></i>
146
+ </div>
147
+ <div class="flex flex-col">
148
+ <a href="#" class="font-bold text-base sm:text-lg text-white hover:text-sky-400 transition leading-tight">
149
+ react-native-live-widgets
150
+ </a>
151
+ <span class="text-[11px] text-slate-400 hidden sm:inline" data-i18n="brand_subtitle">Declarative Widgets & Dynamic Island Engine</span>
152
+ </div>
153
+ <span class="inline-flex items-center px-2 py-0.5 rounded-md text-[11px] font-semibold bg-emerald-500/10 text-emerald-400 border border-emerald-500/20">
154
+ v1.2.1
75
155
  </span>
76
156
  </div>
77
157
 
78
- <nav class="flex items-center space-x-4">
79
- <a href="#quick-start" class="text-sm text-slate-300 hover:text-white hidden md:inline">Cài đặt</a>
80
- <a href="#dsl-catalog" class="text-sm text-slate-300 hover:text-white hidden md:inline">Declarative DSL</a>
81
- <a href="#llms-ai" class="text-sm text-sky-400 font-medium hover:text-sky-300 flex items-center space-x-1">
82
- <i data-lucide="bot" class="w-4 h-4"></i>
83
- <span>AI / llms.txt</span>
84
- </a>
85
- <a href="https://github.com/React-Native-Vu/LiveWidgetsExampleExpo" target="_blank" class="text-sm text-slate-300 hover:text-white hidden lg:inline">
86
- Expo Demo
158
+ <!-- Nav Links & Search -->
159
+ <nav class="flex items-center space-x-3 sm:space-x-4">
160
+ <a href="#interactive-simulator" class="text-xs sm:text-sm text-slate-300 hover:text-white hidden lg:inline flex items-center space-x-1">
161
+ <i data-lucide="play-circle" class="w-4 h-4 text-sky-400"></i>
162
+ <span data-i18n="nav_sim">Live Simulator</span>
87
163
  </a>
88
- <a href="https://github.com/React-Native-Vu/react-native-live-widgets" target="_blank" class="p-2 text-slate-400 hover:text-white transition" title="GitHub">
89
- <i data-lucide="github" class="w-5 h-5"></i>
90
- </a>
91
- <a href="https://www.npmjs.com/package/react-native-live-widgets" target="_blank" class="p-2 text-red-400 hover:text-red-300 transition" title="npm">
92
- <svg class="w-5 h-5 fill-current" viewBox="0 0 780 250"><path d="M240,250h100v-50h100V0H240V250z M340,50h50v100h-50V50z M480,0v200h100V50h50v150h50V50h50v150h50V0H480z M0,200h100V50h50v150h50V0H0V200z"/></svg>
164
+ <a href="#quick-start" class="text-xs sm:text-sm text-slate-300 hover:text-white hidden md:inline" data-i18n="nav_install">Cài đặt</a>
165
+ <a href="#dsl-catalog" class="text-xs sm:text-sm text-slate-300 hover:text-white hidden md:inline" data-i18n="nav_dsl">UI DSL & JSX</a>
166
+ <a href="#core-api" class="text-xs sm:text-sm text-slate-300 hover:text-white hidden md:inline" data-i18n="nav_api">API Reference</a>
167
+
168
+ <a href="#llms-ai" class="text-xs sm:text-sm text-sky-400 font-medium hover:text-sky-300 flex items-center space-x-1 px-2.5 py-1 rounded-lg bg-sky-500/10 border border-sky-500/20">
169
+ <i data-lucide="bot" class="w-4 h-4"></i>
170
+ <span>llms.txt</span>
93
171
  </a>
172
+
173
+ <!-- Language Switcher (VI / EN) -->
174
+ <div class="flex items-center space-x-1 border-l border-cardBorder pl-3">
175
+ <div class="inline-flex items-center rounded-lg bg-slate-800/80 p-0.5 border border-slate-700/80 text-[11px] font-semibold">
176
+ <button id="lang-btn-vi" onclick="switchLanguage('vi')" class="px-2 py-0.5 rounded-md transition text-sky-400 bg-sky-500/20 shadow-sm" title="Tiếng Việt">VI</button>
177
+ <button id="lang-btn-en" onclick="switchLanguage('en')" class="px-2 py-0.5 rounded-md transition text-slate-400 hover:text-white" title="English">EN</button>
178
+ </div>
179
+ </div>
180
+
181
+ <!-- GitHub Repo & Demo links -->
182
+ <div class="flex items-center space-x-1 border-l border-cardBorder pl-3">
183
+ <a href="https://github.com/React-Native-Vu/react-native-live-widgets" target="_blank" class="p-2 text-slate-400 hover:text-white transition rounded-lg hover:bg-slate-800" title="GitHub Repository">
184
+ <i data-lucide="github" class="w-5 h-5"></i>
185
+ </a>
186
+ <a href="https://www.npmjs.com/package/react-native-live-widgets" target="_blank" class="p-2 text-red-400 hover:text-red-300 transition rounded-lg hover:bg-slate-800" title="npm package">
187
+ <svg class="w-5 h-5 fill-current" viewBox="0 0 780 250"><path d="M240,250h100v-50h100V0H240V250z M340,50h50v100h-50V50z M480,0v200h100V50h50v150h50V50h50v150h50V0H480z M0,200h100V50h50v150h50V0H0V200z"/></svg>
188
+ </a>
189
+ </div>
94
190
  </nav>
95
191
  </div>
96
192
  </header>
97
193
 
98
194
  <!-- Hero Section -->
99
- <section class="relative overflow-hidden pt-12 pb-16 lg:pt-20 lg:pb-24 border-b border-cardBorder bg-gradient-to-b from-sky-950/20 to-transparent">
100
- <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 text-center">
101
- <div class="inline-flex items-center space-x-2 px-3 py-1 rounded-full bg-slate-800/80 border border-slate-700 text-xs text-slate-300 mb-6">
102
- <span>✨ Hỗ trợ 100% Expo Config Plugin, EAS Build & Bare React Native</span>
195
+ <section class="relative overflow-hidden pt-12 pb-16 lg:pt-20 lg:pb-24 border-b border-cardBorder bg-gradient-to-b from-sky-950/20 via-slate-900/40 to-transparent bg-grid-pattern">
196
+ <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 text-center relative z-10">
197
+
198
+ <!-- Badges -->
199
+ <div class="inline-flex items-center space-x-2 px-3.5 py-1 rounded-full bg-slate-800/90 border border-slate-700/80 text-xs text-slate-300 mb-6 shadow-inner">
200
+ <span class="w-2 h-2 rounded-full bg-emerald-400 animate-pulse"></span>
201
+ <span data-i18n="hero_badge">100% Declarative UI • Không viết Swift / Kotlin • Expo CNG Ready</span>
103
202
  </div>
104
- <h1 class="text-4xl sm:text-5xl lg:text-6xl font-extrabold text-white tracking-tight leading-tight">
105
- Live Activities & Dynamic Island <br>
106
- <span class="text-transparent bg-clip-text bg-gradient-to-r from-sky-400 via-teal-300 to-indigo-400">
107
- Chỉ bằng TypeScript Declarative
203
+
204
+ <!-- Main Headline -->
205
+ <h1 class="text-4xl sm:text-6xl lg:text-7xl font-extrabold text-white tracking-tight leading-tight sm:leading-none">
206
+ <span data-i18n="hero_title_1">Live Activities & Dynamic Island</span> <br class="hidden sm:inline">
207
+ <span class="text-transparent bg-clip-text bg-gradient-to-r from-sky-400 via-teal-300 to-indigo-400" data-i18n="hero_title_2">
208
+ Chỉ với TypeScript & JSX
108
209
  </span>
109
210
  </h1>
110
- <p class="mt-6 text-lg sm:text-xl text-slate-400 max-w-3xl mx-auto">
111
- Tạo tiện ích Home Screen Widgets và Live Activities Native cho cả iOS và Android mà
112
- <strong>không cần viết 1 dòng mã Swift hay Kotlin</strong>. Tích hợp sẵn chuẩn cho AI Agent & LLMs.
211
+
212
+ <p class="mt-6 text-base sm:text-xl text-slate-300 max-w-3xl mx-auto font-normal leading-relaxed" data-i18n="hero_desc">
213
+ Giải pháp toàn diện All-in-One cho <strong>Live Activities</strong>, <strong>Dynamic Island</strong> và
214
+ <strong>Interactive Home Screen Widgets</strong> trên cả iOS & Android. Tích hợp sẵn bộ mô phỏng <code>&lt;WidgetPreview&gt;</code> và chuẩn dữ liệu mở cho AI Agent.
113
215
  </p>
114
216
 
115
- <div class="mt-8 flex flex-wrap justify-center gap-4">
116
- <a href="#quick-start" class="px-6 py-3 rounded-xl bg-sky-600 hover:bg-sky-500 text-white font-semibold shadow-lg shadow-sky-600/25 transition flex items-center space-x-2">
117
- <i data-lucide="play" class="w-4 h-4"></i>
118
- <span>Bắt đầu ngay</span>
217
+ <!-- CTA Buttons -->
218
+ <div class="mt-8 flex flex-wrap justify-center items-center gap-4">
219
+ <a href="#quick-start" class="px-6 py-3.5 rounded-xl bg-sky-600 hover:bg-sky-500 text-white font-semibold shadow-lg shadow-sky-600/30 hover:shadow-sky-500/40 transition-all duration-200 flex items-center space-x-2">
220
+ <i data-lucide="zap" class="w-4 h-4"></i>
221
+ <span data-i18n="hero_btn_install">Bắt đầu Cài đặt</span>
119
222
  </a>
120
- <a href="https://github.com/React-Native-Vu/LiveWidgetsExampleExpo" target="_blank" class="px-6 py-3 rounded-xl bg-slate-800 hover:bg-slate-700 text-slate-200 border border-slate-700 font-semibold transition flex items-center space-x-2">
121
- <i data-lucide="smartphone" class="w-4 h-4"></i>
122
- <span>Xem Expo Demo</span>
223
+ <a href="#interactive-simulator" class="px-6 py-3.5 rounded-xl bg-slate-800/90 hover:bg-slate-700 text-white border border-slate-700 font-semibold transition flex items-center space-x-2">
224
+ <i data-lucide="play" class="w-4 h-4 text-sky-400"></i>
225
+ <span data-i18n="hero_btn_sim">Trải nghiệm Live Simulator</span>
123
226
  </a>
124
- <a href="llms.txt" target="_blank" class="px-6 py-3 rounded-xl bg-indigo-950/60 hover:bg-indigo-900/60 text-indigo-300 border border-indigo-700/50 font-semibold transition flex items-center space-x-2">
125
- <i data-lucide="file-code" class="w-4 h-4"></i>
126
- <span>Tài liệu cho AI (llms.txt)</span>
227
+ <a href="https://github.com/React-Native-Vu/LiveWidgetsExampleExpo" target="_blank" class="px-6 py-3.5 rounded-xl bg-indigo-950/70 hover:bg-indigo-900/80 text-indigo-300 border border-indigo-700/50 font-semibold transition flex items-center space-x-2">
228
+ <i data-lucide="smartphone" class="w-4 h-4"></i>
229
+ <span data-i18n="hero_btn_expo">Expo Sample App ↗</span>
127
230
  </a>
128
231
  </div>
232
+
233
+ <!-- Quick Command Bar -->
234
+ <div class="mt-8 max-w-lg mx-auto bg-slate-900/90 border border-slate-800 rounded-xl p-2 flex items-center justify-between text-xs sm:text-sm text-slate-300 font-mono">
235
+ <span class="px-2 text-sky-400 select-all">$ npm install react-native-live-widgets</span>
236
+ <button onclick="copyText('npm install react-native-live-widgets', this)" class="px-3 py-1.5 rounded-lg bg-slate-800 hover:bg-slate-700 text-slate-300 hover:text-white transition flex items-center space-x-1">
237
+ <i data-lucide="copy" class="w-3.5 h-3.5"></i>
238
+ <span data-i18n="btn_copy">Copy</span>
239
+ </button>
240
+ </div>
241
+
242
+ </div>
243
+ </section>
244
+
245
+ <!-- Interactive Live Simulator Section (Mô phỏng thời gian thực) -->
246
+ <section id="interactive-simulator" class="py-16 border-b border-cardBorder bg-darkBg">
247
+ <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
248
+
249
+ <div class="text-center max-w-3xl mx-auto mb-10">
250
+ <div class="inline-flex items-center space-x-1 text-xs font-semibold uppercase tracking-wider text-sky-400 mb-2">
251
+ <i data-lucide="sparkles" class="w-4 h-4"></i>
252
+ <span data-i18n="sim_header_badge">Tương tác trực tiếp trên trình duyệt</span>
253
+ </div>
254
+ <h2 class="text-3xl sm:text-4xl font-extrabold text-white" data-i18n="sim_header_title">
255
+ Live Simulator: Trải Nghiệm Widget & Dynamic Island
256
+ </h2>
257
+ <p class="mt-3 text-slate-400 text-sm sm:text-base" data-i18n="sim_header_desc">
258
+ Nhấp chuột vào các chế độ bên dưới để xem Dynamic Island co dãn, sóng âm Equalizer chuyển động và nút bấm Home Widget phản hồi tức thì!
259
+ </p>
260
+ </div>
261
+
262
+ <!-- Simulator Switcher Tabs -->
263
+ <div class="flex flex-wrap justify-center gap-2 mb-8">
264
+ <button onclick="switchSimulator('delivery')" id="btn-sim-delivery" class="sim-btn px-4 py-2 rounded-xl text-xs sm:text-sm font-semibold transition-all bg-sky-600 text-white shadow-lg shadow-sky-600/30 flex items-center space-x-2">
265
+ <i data-lucide="bike" class="w-4 h-4"></i>
266
+ <span data-i18n="sim_tab_delivery">1. Giao đồ ăn (Dynamic Island)</span>
267
+ </button>
268
+ <button onclick="switchSimulator('music')" id="btn-sim-music" class="sim-btn px-4 py-2 rounded-xl text-xs sm:text-sm font-semibold transition-all bg-slate-800 text-slate-300 hover:text-white hover:bg-slate-700 border border-slate-700 flex items-center space-x-2">
269
+ <i data-lucide="music" class="w-4 h-4"></i>
270
+ <span data-i18n="sim_tab_music">2. Sóng nhạc Equalizer</span>
271
+ </button>
272
+ <button onclick="switchSimulator('pomodoro')" id="btn-sim-pomodoro" class="sim-btn px-4 py-2 rounded-xl text-xs sm:text-sm font-semibold transition-all bg-slate-800 text-slate-300 hover:text-white hover:bg-slate-700 border border-slate-700 flex items-center space-x-2">
273
+ <i data-lucide="timer" class="w-4 h-4"></i>
274
+ <span data-i18n="sim_tab_pomodoro">3. Bấm giờ Phần cứng (UI.Timer)</span>
275
+ </button>
276
+ <button onclick="switchSimulator('widget-interactive')" id="btn-sim-widget-interactive" class="sim-btn px-4 py-2 rounded-xl text-xs sm:text-sm font-semibold transition-all bg-slate-800 text-slate-300 hover:text-white hover:bg-slate-700 border border-slate-700 flex items-center space-x-2">
277
+ <i data-lucide="layout" class="w-4 h-4"></i>
278
+ <span data-i18n="sim_tab_widget">4. Home Widget Tương Tác 2 Chiều</span>
279
+ </button>
280
+ </div>
281
+
282
+ <!-- Main Simulator Mockup Canvas -->
283
+ <div class="max-w-4xl mx-auto bg-darkCard border border-cardBorder rounded-2xl p-6 sm:p-8 shadow-2xl relative">
284
+ <div class="grid grid-cols-1 lg:grid-cols-12 gap-8 items-center">
285
+
286
+ <!-- Virtual Phone Display Area -->
287
+ <div class="lg:col-span-6 flex flex-col items-center justify-center">
288
+
289
+ <!-- Dynamic Island Container -->
290
+ <div id="sim-island-box" class="w-full max-w-sm bg-black border border-slate-800 rounded-[28px] p-4 text-white shadow-2xl island-container transition-all duration-300 relative overflow-hidden">
291
+ <!-- Content injected via JS -->
292
+ </div>
293
+
294
+ <!-- Hint below phone -->
295
+ <p id="sim-hint" class="mt-4 text-xs text-slate-500 text-center flex items-center space-x-1">
296
+ <i data-lucide="info" class="w-3.5 h-3.5"></i>
297
+ <span data-i18n="sim_hint">Nhấn vào các nút bên trong widget để thấy phản hồi tương tác!</span>
298
+ </p>
299
+ </div>
300
+
301
+ <!-- Code Snippet for Current Simulator State -->
302
+ <div class="lg:col-span-6 flex flex-col">
303
+ <div class="flex items-center justify-between mb-2">
304
+ <span id="sim-code-label" class="text-xs font-semibold text-slate-400 uppercase tracking-wider" data-i18n="sim_code_label">
305
+ Mã TypeScript Declarative
306
+ </span>
307
+ <button onclick="copySimulatorCode()" class="text-xs text-sky-400 hover:text-sky-300 flex items-center space-x-1">
308
+ <i data-lucide="copy" class="w-3.5 h-3.5"></i>
309
+ <span data-i18n="btn_copy_code">Copy Code</span>
310
+ </button>
311
+ </div>
312
+ <div class="relative">
313
+ <pre class="overflow-x-auto"><code id="sim-code" class="language-typescript">// Mã nguồn tương ứng
314
+ </code></pre>
315
+ </div>
316
+ </div>
317
+
318
+ </div>
319
+ </div>
320
+
129
321
  </div>
130
322
  </section>
131
323
 
132
- <!-- Main Content Layout -->
133
- <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-10 flex-1 grid grid-cols-1 lg:grid-cols-4 gap-8">
324
+ <!-- Key Architecture Feature Grid -->
325
+ <section class="py-16 border-b border-cardBorder bg-slate-950/40">
326
+ <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
327
+
328
+ <div class="text-center max-w-3xl mx-auto mb-12">
329
+ <h2 class="text-2xl sm:text-3xl font-bold text-white" data-i18n="why_title">Tại sao chọn `react-native-live-widgets`?</h2>
330
+ <p class="mt-2 text-slate-400 text-sm sm:text-base" data-i18n="why_desc">Kiến trúc đột phá giúp phát triển Widget Native nhanh gấp 10 lần mà vẫn bảo toàn hiệu năng tối đa.</p>
331
+ </div>
332
+
333
+ <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6">
334
+
335
+ <!-- Feature 1 -->
336
+ <div class="bg-darkCard border border-cardBorder hover:border-sky-500/40 rounded-2xl p-6 transition-all duration-200 hover:-translate-y-1">
337
+ <div class="w-12 h-12 rounded-xl bg-sky-500/10 border border-sky-500/20 text-sky-400 flex items-center justify-center mb-4">
338
+ <i data-lucide="code-2" class="w-6 h-6"></i>
339
+ </div>
340
+ <h3 class="text-lg font-bold text-white" data-i18n="f1_title">100% Không Viết Swift / Kotlin</h3>
341
+ <p class="mt-2 text-sm text-slate-400 leading-relaxed" data-i18n="f1_desc">
342
+ Viết giao diện hoàn toàn bằng JavaScript/TypeScript hoặc cú pháp JSX. Thư viện tự động chuyển đổi thành cây Native AST cho WidgetKit và RemoteViews.
343
+ </p>
344
+ </div>
345
+
346
+ <!-- Feature 2 -->
347
+ <div class="bg-darkCard border border-cardBorder hover:border-emerald-500/40 rounded-2xl p-6 transition-all duration-200 hover:-translate-y-1">
348
+ <div class="w-12 h-12 rounded-xl bg-emerald-500/10 border border-emerald-500/20 text-emerald-400 flex items-center justify-center mb-4">
349
+ <i data-lucide="mouse-pointer-click" class="w-6 h-6"></i>
350
+ </div>
351
+ <h3 class="text-lg font-bold text-white" data-i18n="f2_title">Tương Tác 2 Chiều (AppIntents)</h3>
352
+ <p class="mt-2 text-sm text-slate-400 leading-relaxed" data-i18n="f2_desc">
353
+ Nút bấm trên Home Widget kích hoạt trực tiếp hàm JavaScript trong React Native qua React Hook <code>useWidgetAction()</code> mà không cần mở toàn màn hình ứng dụng.
354
+ </p>
355
+ </div>
356
+
357
+ <!-- Feature 3 -->
358
+ <div class="bg-darkCard border border-cardBorder hover:border-amber-500/40 rounded-2xl p-6 transition-all duration-200 hover:-translate-y-1">
359
+ <div class="w-12 h-12 rounded-xl bg-amber-500/10 border border-amber-500/20 text-amber-400 flex items-center justify-center mb-4">
360
+ <i data-lucide="battery-charging" class="w-6 h-6"></i>
361
+ </div>
362
+ <h3 class="text-lg font-bold text-white" data-i18n="f3_title">Timer Phần Cứng (0% Tiêu Hao Pin)</h3>
363
+ <p class="mt-2 text-sm text-slate-400 leading-relaxed" data-i18n="f3_desc">
364
+ <code>UI.Timer</code> tự động đếm giây mượt mà trên Dynamic Island dựa vào chip hệ thống của iOS/Android mà không làm thức giấc CPU hay hao tổn pin thiết bị.
365
+ </p>
366
+ </div>
367
+
368
+ <!-- Feature 4 -->
369
+ <div class="bg-darkCard border border-cardBorder hover:border-purple-500/40 rounded-2xl p-6 transition-all duration-200 hover:-translate-y-1">
370
+ <div class="w-12 h-12 rounded-xl bg-purple-500/10 border border-purple-500/20 text-purple-400 flex items-center justify-center mb-4">
371
+ <i data-lucide="radio" class="w-6 h-6"></i>
372
+ </div>
373
+ <h3 class="text-lg font-bold text-white" data-i18n="f4_title">Sóng Nhạc Động (Equalizer)</h3>
374
+ <p class="mt-2 text-sm text-slate-400 leading-relaxed" data-i18n="f4_desc">
375
+ Duy nhất trên thị trường hỗ trợ hiệu ứng sóng âm thanh chuyển động liên tục cho ứng dụng nghe nhạc, podcast, radio trực tiếp trên Dynamic Island & Notification.
376
+ </p>
377
+ </div>
378
+
379
+ <!-- Feature 5 -->
380
+ <div class="bg-darkCard border border-cardBorder hover:border-indigo-500/40 rounded-2xl p-6 transition-all duration-200 hover:-translate-y-1">
381
+ <div class="w-12 h-12 rounded-xl bg-indigo-500/10 border border-indigo-500/20 text-indigo-400 flex items-center justify-center mb-4">
382
+ <i data-lucide="cloud-lightning" class="w-6 h-6"></i>
383
+ </div>
384
+ <h3 class="text-lg font-bold text-white" data-i18n="f5_title">Đồng Bộ Ngầm Khi Kill App</h3>
385
+ <p class="mt-2 text-sm text-slate-400 leading-relaxed" data-i18n="f5_desc">
386
+ Hàm <code>Widget.setRemoteConfig()</code> cho phép cấu hình URL API ngầm để hệ điều hành iOS/Android tự động fetch dữ liệu mới cho Widget kể cả khi ứng dụng đã bị tắt.
387
+ </p>
388
+ </div>
389
+
390
+ <!-- Feature 6 -->
391
+ <div class="bg-darkCard border border-cardBorder hover:border-teal-500/40 rounded-2xl p-6 transition-all duration-200 hover:-translate-y-1">
392
+ <div class="w-12 h-12 rounded-xl bg-teal-500/10 border border-teal-500/20 text-teal-400 flex items-center justify-center mb-4">
393
+ <i data-lucide="bot" class="w-6 h-6"></i>
394
+ </div>
395
+ <h3 class="text-lg font-bold text-white" data-i18n="f6_title">Chuẩn AI Agent (llms.txt)</h3>
396
+ <p class="mt-2 text-sm text-slate-400 leading-relaxed" data-i18n="f6_desc">
397
+ Sẵn sàng 100% cho ChatGPT, Claude Code, Cursor, Antigravity thông qua <code>llms.txt</code> và <code>SKILL.md</code>. Agent của bạn có thể tự lập trình widget không lỗi.
398
+ </p>
399
+ </div>
400
+ <p class="mt-2 text-sm text-slate-400 leading-relaxed">
401
+ Sẵn sàng 100% cho ChatGPT, Claude Code, Cursor, Antigravity thông qua <code>llms.txt</code> và <code>SKILL.md</code>. Agent của bạn có thể tự lập trình widget không lỗi.
402
+ </p>
403
+ </div>
404
+
405
+ </div>
406
+
407
+ </div>
408
+ </section>
409
+
410
+ <!-- Main Content Layout with Sticky Sidebar -->
411
+ <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-12 flex-1 grid grid-cols-1 lg:grid-cols-4 gap-10">
134
412
 
135
413
  <!-- Sidebar Navigation -->
136
- <aside class="hidden lg:block lg:col-span-1 space-y-6 sticky top-24 h-[calc(100vh-8rem)] overflow-y-auto custom-scrollbar pr-2">
414
+ <aside id="docs-sidebar" class="hidden lg:block lg:col-span-1 space-y-6 sticky top-24 h-[calc(100vh-8rem)] overflow-y-auto pr-2 text-sm">
415
+
137
416
  <div>
138
- <h4 class="text-xs font-semibold text-slate-400 uppercase tracking-wider mb-2">Bắt đầu</h4>
139
- <ul class="space-y-1.5 text-sm">
140
- <li><a href="#quick-start" class="text-sky-400 font-medium block py-1 hover:text-sky-300">Cài đặt & Thiết lập</a></li>
141
- <li><a href="#expo-setup" class="text-slate-400 hover:text-slate-200 block py-1">Dành cho Expo (CNG)</a></li>
142
- <li><a href="#bare-rn-setup" class="text-slate-400 hover:text-slate-200 block py-1">Dành cho Bare React Native</a></li>
417
+ <h4 class="text-xs font-bold text-sky-400 uppercase tracking-wider mb-2.5 flex items-center space-x-1.5">
418
+ <i data-lucide="rocket" class="w-4 h-4"></i>
419
+ <span>Bắt đầu</span>
420
+ </h4>
421
+ <ul class="space-y-1 border-l border-slate-800 pl-3">
422
+ <li><a href="#quick-start" class="sidebar-link text-slate-300 hover:text-white block py-1 transition" data-i18n="side_quick_start">Cài đặt All-in-One CLI</a></li>
423
+ <li><a href="#expo-setup" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_expo_setup">Expo (Config Plugin &amp; CNG)</a></li>
424
+ <li><a href="#bare-rn-setup" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_bare_rn">Bare React Native CLI</a></li>
143
425
  </ul>
144
426
  </div>
145
427
 
146
428
  <div>
147
- <h4 class="text-xs font-semibold text-slate-400 uppercase tracking-wider mb-2">Declarative UI DSL</h4>
148
- <ul class="space-y-1.5 text-sm">
149
- <li><a href="#dsl-containers" class="text-slate-400 hover:text-slate-200 block py-1">VStack / HStack / ZStack</a></li>
150
- <li><a href="#dsl-timer" class="text-slate-400 hover:text-slate-200 block py-1">UI.Timer (Phần cứng)</a></li>
151
- <li><a href="#dsl-progress" class="text-slate-400 hover:text-slate-200 block py-1">UI.Progress (Bar, Circular)</a></li>
152
- <li><a href="#dsl-equalizer" class="text-slate-400 hover:text-slate-200 block py-1">UI.Equalizer (Sóng nhạc)</a></li>
153
- <li><a href="#dsl-interactive" class="text-slate-400 hover:text-slate-200 block py-1">UI.Button (Tương tác 2 chiều)</a></li>
429
+ <h4 class="text-xs font-bold text-sky-400 uppercase tracking-wider mb-2.5 flex items-center space-x-1.5">
430
+ <i data-lucide="code" class="w-4 h-4"></i>
431
+ <span>Cú pháp &amp; UI Engine</span>
432
+ </h4>
433
+ <ul class="space-y-1 border-l border-slate-800 pl-3">
434
+ <li><a href="#jsx-support" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_jsx_support">Cú pháp JSX / TSX &amp; StyleSheet</a></li>
435
+ <li><a href="#widget-preview-comp" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_widget_preview">Mô phỏng &lt;WidgetPreview&gt;</a></li>
436
+ <li><a href="#exact-hit-layer" class="sidebar-link text-emerald-400 hover:text-white block py-1 transition font-medium" data-i18n="side_exact_hit">Exact Hit Layer &amp; Chronometer (v1.2.1)</a></li>
437
+ <li><a href="#dsl-containers" class="sidebar-link text-slate-400 hover:text-white block py-1 transition">VStack, HStack, ZStack, Grid, Divider</a></li>
438
+ <li><a href="#dsl-text-badge" class="sidebar-link text-slate-400 hover:text-white block py-1 transition">UI.Text, UI.Badge &amp; Biến động</a></li>
439
+ <li><a href="#dsl-image" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_dsl_image">UI.Image &amp; System Icons (Apple / Google)</a></li>
440
+ <li><a href="#dsl-timer" class="sidebar-link text-slate-400 hover:text-white block py-1 transition">UI.Timer (Đếm giờ phần cứng)</a></li>
441
+ <li><a href="#dsl-progress" class="sidebar-link text-slate-400 hover:text-white block py-1 transition">UI.Progress (Bar, Segmented, Circle)</a></li>
442
+ <li><a href="#dsl-equalizer" class="sidebar-link text-slate-400 hover:text-white block py-1 transition">UI.Equalizer (Sóng âm)</a></li>
443
+ <li><a href="#dsl-gauge-chart" class="sidebar-link text-slate-400 hover:text-white block py-1 transition">UI.Gauge 240° &amp; UI.Chart</a></li>
444
+ <li><a href="#dsl-interactive" class="sidebar-link text-slate-400 hover:text-white block py-1 transition">UI.Button, UI.Toggle &amp; UI.Link</a></li>
445
+ <li><a href="#dsl-custom" class="sidebar-link text-slate-400 hover:text-white block py-1 transition">UI.Custom &amp; DynamicNodeRegistry</a></li>
446
+ <li><a href="#styling-modifiers" class="sidebar-link text-slate-400 hover:text-white block py-1 transition">Gradient, Shadow, Border, Tinted</a></li>
154
447
  </ul>
155
448
  </div>
156
449
 
157
450
  <div>
158
- <h4 class="text-xs font-semibold text-slate-400 uppercase tracking-wider mb-2">AI Agent & LLM</h4>
159
- <ul class="space-y-1.5 text-sm">
160
- <li><a href="#llms-ai" class="text-indigo-400 hover:text-indigo-300 font-medium block py-1">llms.txt Standard</a></li>
161
- <li><a href="#agent-skill" class="text-indigo-400 hover:text-indigo-300 block py-1">Agent Skill (SKILL.md)</a></li>
451
+ <h4 class="text-xs font-bold text-sky-400 uppercase tracking-wider mb-2.5 flex items-center space-x-1.5">
452
+ <i data-lucide="book-open" class="w-4 h-4"></i>
453
+ <span>Core API Reference</span>
454
+ </h4>
455
+ <ul class="space-y-1 border-l border-slate-800 pl-3">
456
+ <li><a href="#api-liveactivity" class="sidebar-link text-slate-400 hover:text-white block py-1 transition">LiveActivity &amp; Dynamic Island</a></li>
457
+ <li><a href="#api-widget" class="sidebar-link text-slate-400 hover:text-white block py-1 transition">Widget API, Multi-page &amp; Lock Screen</a></li>
458
+ <li><a href="#api-hooks" class="sidebar-link text-slate-400 hover:text-white block py-1 transition">React Hooks &amp; SharedStorage</a></li>
459
+ <li><a href="#api-remote-sync" class="sidebar-link text-slate-400 hover:text-white block py-1 transition">Remote API Sync (Kill App)</a></li>
460
+ <li><a href="#api-push-token" class="sidebar-link text-slate-400 hover:text-white block py-1 transition">APNs &amp; FCM Push Tokens</a></li>
162
461
  </ul>
163
462
  </div>
164
463
 
165
464
  <div>
166
- <h4 class="text-xs font-semibold text-slate-400 uppercase tracking-wider mb-2">Tài nguyên & Demo</h4>
167
- <ul class="space-y-1.5 text-sm">
168
- <li><a href="https://github.com/React-Native-Vu/LiveWidgetsExampleExpo" target="_blank" class="text-slate-400 hover:text-slate-200 block py-1">Expo Demo GitHub ↗</a></li>
169
- <li><a href="https://github.com/React-Native-Vu/LiveWidgetsExample" target="_blank" class="text-slate-400 hover:text-slate-200 block py-1">Bare RN Demo GitHub ↗</a></li>
170
- <li><a href="GUIDE-VI.md" target="_blank" class="text-slate-400 hover:text-slate-200 block py-1">Tài liệu chi tiết (Tiếng Việt) ↗</a></li>
171
- <li><a href="GUIDE-EN.md" target="_blank" class="text-slate-400 hover:text-slate-200 block py-1">Full English Guide ↗</a></li>
465
+ <h4 class="text-xs font-bold text-emerald-400 uppercase tracking-wider mb-2.5 flex items-center space-x-1.5">
466
+ <i data-lucide="cpu" class="w-4 h-4"></i>
467
+ <span>Kiến trúc &amp; Trợ năng (v1.2.1)</span>
468
+ </h4>
469
+ <ul class="space-y-1 border-l border-emerald-950 pl-3">
470
+ <li><a href="#ir-semantic" class="sidebar-link text-slate-400 hover:text-white block py-1 transition">3 Trụ cột Kiến trúc &amp; UI IR</a></li>
471
+ <li><a href="#a11y-layer" class="sidebar-link text-slate-400 hover:text-white block py-1 transition">Accessibility (VoiceOver &amp; TalkBack)</a></li>
472
+ <li><a href="#capability-matrix" class="sidebar-link text-slate-400 hover:text-white block py-1 transition">Bảng Năng lực &amp; Lộ trình 6 Phases</a></li>
473
+ <li><a href="#extended-families-lifecycle" class="sidebar-link text-emerald-400 hover:text-white block py-1 transition font-medium">StandBy, ControlWidget &amp; Lifecycle</a></li>
474
+ <li><a href="#troubleshooting" class="sidebar-link text-slate-400 hover:text-white block py-1 transition">Xử lý sự cố thường gặp</a></li>
172
475
  </ul>
173
476
  </div>
477
+
478
+ <div>
479
+ <h4 class="text-xs font-bold text-indigo-400 uppercase tracking-wider mb-2.5 flex items-center space-x-1.5">
480
+ <i data-lucide="bot" class="w-4 h-4"></i>
481
+ <span>AI Agent &amp; LLMs</span>
482
+ </h4>
483
+ <ul class="space-y-1 border-l border-indigo-950 pl-3">
484
+ <li><a href="#llms-ai" class="sidebar-link text-slate-400 hover:text-white block py-1 transition">Chuẩn mở llms.txt &amp; llms-full.txt</a></li>
485
+ <li><a href="#agent-skill" class="sidebar-link text-slate-400 hover:text-white block py-1 transition">Agent Skill (SKILL.md)</a></li>
486
+ </ul>
487
+ </div>
488
+
489
+ <div>
490
+ <h4 class="text-xs font-bold text-slate-500 uppercase tracking-wider mb-2.5 flex items-center space-x-1.5">
491
+ <i data-lucide="external-link" class="w-4 h-4"></i>
492
+ <span>Tài nguyên ngoài</span>
493
+ </h4>
494
+ <ul class="space-y-1 border-l border-slate-800 pl-3 text-xs">
495
+ <li><a href="https://react-native-vu.github.io/react-native-live-widgets/" target="_blank" class="text-sky-400 hover:text-sky-300 block py-1 font-medium">Web Docs Chính Thức ↗</a></li>
496
+ <li><a href="https://github.com/React-Native-Vu/LiveWidgetsExampleExpo" target="_blank" class="text-slate-400 hover:text-sky-300 block py-1">Expo Demo GitHub ↗</a></li>
497
+ <li><a href="https://github.com/React-Native-Vu/LiveWidgetsExample" target="_blank" class="text-slate-400 hover:text-sky-300 block py-1">Bare RN Demo GitHub ↗</a></li>
498
+ <li><a href="GUIDE-VI.md" target="_blank" class="text-slate-400 hover:text-sky-300 block py-1">Hướng Dẫn Chi Tiết (VI) ↗</a></li>
499
+ <li><a href="GUIDE-EN.md" target="_blank" class="text-slate-400 hover:text-sky-300 block py-1">English Full Guide ↗</a></li>
500
+ </ul>
501
+ </div>
502
+
174
503
  </aside>
175
504
 
176
505
  <!-- Main Content Area -->
177
- <main class="lg:col-span-3 space-y-12">
506
+ <main class="lg:col-span-3 space-y-16">
178
507
 
179
508
  <!-- Section: Quick Start -->
180
509
  <section id="quick-start" class="space-y-6">
181
- <h2 class="text-2xl sm:text-3xl font-bold text-white flex items-center space-x-2">
182
- <i data-lucide="zap" class="w-6 h-6 text-sky-400"></i>
183
- <span>Cài đặt & Thiết lập tự động</span>
184
- </h2>
185
-
186
- <p class="text-slate-300">
187
- Thư viện cung cấp bộ công cụ <strong>All-in-One CLI Scaffolder</strong> giúp tự động tạo Xcode Extension target,
188
- cấu hình App Groups và Android permissions chỉ với 1 câu lệnh duy nhất.
189
- </p>
510
+ <div class="border-b border-cardBorder pb-4">
511
+ <h2 class="text-2xl sm:text-3xl font-extrabold text-white flex items-center space-x-2.5">
512
+ <i data-lucide="zap" class="w-7 h-7 text-sky-400"></i>
513
+ <span>Cài đặt & Thiết lập Tự động</span>
514
+ </h2>
515
+ <p class="mt-2 text-slate-400 text-sm sm:text-base">
516
+ Thư viện tích hợp sẵn bộ <strong>All-in-One CLI Scaffolder</strong> giúp cấu hình Xcode Widget Extension, App Groups và Android permissions chỉ với 1 câu lệnh duy nhất.
517
+ </p>
518
+ </div>
190
519
 
191
- <!-- Expo Tab -->
192
- <div id="expo-setup" class="bg-cardBg border border-cardBorder rounded-xl p-5 space-y-4">
520
+ <!-- Expo Setup Card -->
521
+ <div id="expo-setup" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4 shadow-lg">
193
522
  <div class="flex items-center justify-between">
194
- <span class="font-bold text-white flex items-center space-x-2">
195
- <span class="w-2.5 h-2.5 rounded-full bg-emerald-400"></span>
196
- <span>1. Quy trình dành cho Expo (SDK 50, 51, 52, 58+)</span>
523
+ <span class="font-bold text-white text-base sm:text-lg flex items-center space-x-2">
524
+ <span class="w-3 h-3 rounded-full bg-emerald-400"></span>
525
+ <span>1. Quy trình dành cho Expo (SDK 50, 51, 52, 58+ CNG)</span>
526
+ </span>
527
+ <span class="text-xs bg-emerald-500/10 text-emerald-400 px-2.5 py-1 rounded-full border border-emerald-500/20 font-semibold">
528
+ Config Plugin
197
529
  </span>
198
- <span class="text-xs bg-emerald-500/10 text-emerald-400 px-2 py-0.5 rounded border border-emerald-500/20">Config Plugin</span>
199
530
  </div>
200
531
 
201
- <pre><code class="language-bash"># Bước 1: Cài đặt package
202
- npx expo install react-native-live-widgets
203
-
204
- # Bước 2: Thêm plugin vào app.json
205
- # (xem mẫu cấu hình bên dưới)
532
+ <p class="text-sm text-slate-300 leading-relaxed">
533
+ Thư viện tương thích 100% với <strong>Continuous Native Generation (CNG)</strong> và <strong>EAS Build</strong>:
534
+ </p>
206
535
 
207
- # Bước 3: Sinh thư mục native
208
- npx expo prebuild
536
+ <div class="relative">
537
+ <button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
538
+ <pre><code class="language-bash"># Bước 1: Cài đặt thư viện
539
+ npx expo install react-native-live-widgets
209
540
 
210
- # Bước 4: Tự động cấu hình Widget Extension target & App Groups
211
- npx react-native-live-widgets init --group group.com.yourcompany.app
541
+ # Bước 2: Thiết lập tự động 1 lệnh (tự cấu hình app.json, tạo widgets.config.ts, sync icons & Swift)
542
+ npx react-native-live-widgets init
212
543
 
213
- # Bước 5: Chạy ứng dụng trên Simulator
214
- npx expo run:ios</code></pre>
544
+ # Bước 3: Chạy ứng dụng trên máy ảo / thiết bị thật
545
+ npx expo run:ios
546
+ npx expo run:android</code></pre>
547
+ </div>
215
548
 
216
- <p class="text-xs text-slate-400">Cấu hình plugin trong <code class="text-sky-300">app.json</code>:</p>
217
- <pre><code class="language-json">{
549
+ <p class="text-xs font-semibold text-slate-300">Cấu hình Config Plugin được tự động thêm vào tập tin <code class="text-sky-300">app.json</code>:</p>
550
+ <div class="relative">
551
+ <button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
552
+ <pre><code class="language-json">{
218
553
  "expo": {
554
+ "name": "MyAwesomeApp",
555
+ "slug": "my-awesome-app",
219
556
  "plugins": [
220
557
  [
221
558
  "react-native-live-widgets",
@@ -228,189 +565,1324 @@ npx expo run:ios</code></pre>
228
565
  ]
229
566
  }
230
567
  }</code></pre>
568
+ </div>
231
569
  </div>
232
570
 
233
- <!-- Bare RN Tab -->
234
- <div id="bare-rn-setup" class="bg-cardBg border border-cardBorder rounded-xl p-5 space-y-4">
235
- <span class="font-bold text-white flex items-center space-x-2">
236
- <span class="w-2.5 h-2.5 rounded-full bg-sky-400"></span>
237
- <span>2. Quy trình dành cho Bare React Native CLI</span>
238
- </span>
239
- <pre><code class="language-bash">npm install react-native-live-widgets
240
- # Tự động inject Xcode target, entitlements, podfile và android permissions
241
- npx react-native-live-widgets init --group group.com.yourcompany.app
242
- npx react-native run-ios</code></pre>
571
+ <!-- Bare RN Setup Card -->
572
+ <div id="bare-rn-setup" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4 shadow-lg">
573
+ <div class="flex items-center justify-between">
574
+ <span class="font-bold text-white text-base sm:text-lg flex items-center space-x-2">
575
+ <span class="w-3 h-3 rounded-full bg-sky-400"></span>
576
+ <span>2. Quy trình dành cho Bare React Native CLI</span>
577
+ </span>
578
+ <span class="text-xs bg-sky-500/10 text-sky-400 px-2.5 py-1 rounded-full border border-sky-500/20 font-semibold">
579
+ CLI Auto-Link
580
+ </span>
581
+ </div>
582
+
583
+ <div class="relative">
584
+ <button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
585
+ <pre><code class="language-bash"># Bước 1: Cài đặt package
586
+ npm install react-native-live-widgets
587
+ # hoặc: yarn add react-native-live-widgets
588
+
589
+ # Bước 2: Tự động cấu hình Xcode Target, Entitlements, Podfile, pod install, Android permissions và Swift bundle
590
+ npx react-native-live-widgets init
591
+
592
+ # Bước 3: Khởi chạy dự án
593
+ npx react-native run-ios
594
+ npx react-native run-android</code></pre>
595
+ </div>
596
+ </div>
597
+
598
+ <!-- Codegen Card -->
599
+ <div id="codegen-setup" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4 shadow-lg">
600
+ <div class="flex items-center justify-between">
601
+ <span class="font-bold text-white text-base sm:text-lg flex items-center space-x-2">
602
+ <span class="w-3 h-3 rounded-full bg-purple-400"></span>
603
+ <span>3. Lệnh đồng bộ Codegen &amp; Đa ngôn ngữ (i18n)</span>
604
+ </span>
605
+ <span class="text-xs bg-purple-500/10 text-purple-400 px-2.5 py-1 rounded-full border border-purple-500/20 font-semibold">
606
+ Codegen Engine
607
+ </span>
608
+ </div>
609
+ <p class="text-sm text-slate-300 leading-relaxed">
610
+ Mỗi khi bạn thêm widget mới hoặc chỉnh sửa nội dung trong tập tin <code class="text-sky-300">widgets.config.ts</code>, chỉ cần chạy 1 câu lệnh để tự động cập nhật toàn bộ:
611
+ </p>
612
+ <div class="relative">
613
+ <button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
614
+ <pre><code class="language-bash">npx react-native-live-widgets codegen</code></pre>
615
+ </div>
243
616
  </div>
244
617
  </section>
245
618
 
246
- <!-- Section: Declarative UI DSL -->
247
- <section id="dsl-catalog" class="space-y-6">
248
- <h2 class="text-2xl sm:text-3xl font-bold text-white flex items-center space-x-2">
249
- <i data-lucide="layers" class="w-6 h-6 text-sky-400"></i>
250
- <span>Declarative UI Engine (`UI.*`)</span>
251
- </h2>
252
- <p class="text-slate-300">
253
- Không cần viết SwiftUI hay Kotlin RemoteViews! Khai báo cây giao diện trực tiếp trong TypeScript và hệ thống sẽ tự động ánh xạ sang Native:
254
- </p>
619
+ <!-- Section: JSX Syntax & WidgetPreview Component -->
620
+ <section id="jsx-support" class="space-y-6">
621
+ <div class="border-b border-cardBorder pb-4">
622
+ <div class="flex items-center space-x-2">
623
+ <span class="px-2.5 py-0.5 rounded-full text-xs font-bold bg-sky-500/20 text-sky-300 border border-sky-500/30 uppercase">JSX / TSX</span>
624
+ <h2 class="text-2xl sm:text-3xl font-extrabold text-white">
625
+ Cú pháp JSX / TSX &amp; <code>UI.StyleSheet</code>
626
+ </h2>
627
+ </div>
628
+ <p class="mt-2 text-slate-400 text-sm sm:text-base leading-relaxed">
629
+ Bạn có thể viết giao diện Widget theo <strong>2 phong cách</strong> tương đương 100%: thẻ JSX tự nhiên (<code>&lt;VStack&gt;</code>, <code>&lt;HStack&gt;</code>, <code>&lt;Text&gt;</code>...) với <code>style</code> / mảng conditional style, hoặc bộ hàm <code>UI.*</code> kết hợp <code>UI.StyleSheet.create(...)</code>. Cả <code>Widget.setLayout()</code> và <code>LiveActivity.start()</code> tự động biên dịch JSX sang JSON AST gốc.
630
+ </p>
631
+ </div>
255
632
 
256
- <div class="grid grid-cols-1 md:grid-cols-2 gap-4">
257
- <!-- Card: Live Activity Example -->
258
- <div class="bg-cardBg border border-cardBorder rounded-xl p-4 space-y-3">
259
- <div class="flex items-center justify-between">
260
- <span class="text-sm font-semibold text-white">🚀 Live Activity & Dynamic Island</span>
261
- <span class="text-xs text-sky-400 bg-sky-500/10 px-2 py-0.5 rounded">iOS 16.1+</span>
633
+ <div class="grid grid-cols-1 lg:grid-cols-2 gap-6">
634
+ <div class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
635
+ <h3 class="font-bold text-white text-base flex items-center space-x-2">
636
+ <i data-lucide="braces" class="w-5 h-5 text-sky-400"></i>
637
+ <span>Phong cách 1: JSX Components &amp; StyleSheet</span>
638
+ </h3>
639
+ <p class="text-xs text-slate-400 leading-relaxed">
640
+ Hỗ trợ <code>&lt;VStack&gt;</code>, <code>&lt;HStack&gt;</code>, <code>&lt;ZStack&gt;</code>, <code>&lt;Grid&gt;</code>, <code>&lt;Text&gt;</code>, <code>&lt;Button&gt;</code>, <code>&lt;Toggle&gt;</code>, <code>&lt;Switch&gt;</code>, <code>&lt;Checkbox&gt;</code>, <code>&lt;Badge&gt;</code>, <code>&lt;Progress&gt;</code>, <code>&lt;Timer&gt;</code>, <code>&lt;Equalizer&gt;</code>, <code>&lt;Image&gt;</code>, <code>&lt;Gauge&gt;</code>, <code>&lt;Chart&gt;</code>, <code>&lt;Link&gt;</code>, <code>&lt;Spacer&gt;</code>, <code>&lt;Divider&gt;</code>.
641
+ </p>
642
+ <div class="relative">
643
+ <button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
644
+ <pre><code class="language-tsx">import {
645
+ Widget, VStack, HStack, Text, Badge, Button, Spacer, UI
646
+ } from 'react-native-live-widgets';
647
+
648
+ const styles = UI.StyleSheet.create({
649
+ card: { padding: 16, backgroundColor: '#0F172A', borderRadius: 18 },
650
+ title: { fontSize: 15, fontWeight: 'bold', color: '#FFFFFF' },
651
+ });
652
+
653
+ await Widget.setLayout('main', {
654
+ medium: (
655
+ &lt;VStack style={styles.card} spacing={8}&gt;
656
+ &lt;HStack alignment="center"&gt;
657
+ &lt;Text style={styles.title}&gt;Ca Làm Việc Hôm Nay&lt;/Text&gt;
658
+ &lt;Spacer /&gt;
659
+ &lt;Badge text="08:00 - 17:30" backgroundColor="#064E3B" textColor="#6EE7B7" /&gt;
660
+ &lt;/HStack&gt;
661
+ &lt;Text fontSize={13} color="#94A3B8"&gt;Văn phòng Fastdo Đà Nẵng&lt;/Text&gt;
662
+ &lt;Button
663
+ title="⚡ Check-in Ngay"
664
+ actionId="FASTDO_CHECKIN"
665
+ backgroundColor="#0284C7"
666
+ textColor="#FFFFFF"
667
+ fullWidth
668
+ /&gt;
669
+ &lt;/VStack&gt;
670
+ ),
671
+ });</code></pre>
262
672
  </div>
263
- <pre><code class="language-typescript">await LiveActivity.start({
264
- activityName: 'Delivery',
265
- appGroup: 'group.com.myapp',
266
- layout: UI.VStack({
267
- padding: 16,
268
- backgroundColor: '#0F172A',
269
- children: [
270
- UI.Text('Tài xế đang giao đơn', {
271
- color: '#FFFFFF',
272
- fontSize: 15,
273
- fontWeight: 'bold'
274
- }),
275
- UI.Progress({
276
- style: 'bar',
277
- value: 0.7,
278
- tintColor: '#38BDF8',
279
- height: 6
280
- })
281
- ]
673
+ </div>
674
+
675
+ <div class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
676
+ <h3 class="font-bold text-white text-base flex items-center space-x-2">
677
+ <i data-lucide="function-square" class="w-5 h-5 text-indigo-400"></i>
678
+ <span>Phong cách 2: Functional DSL &amp; Conditional Styles</span>
679
+ </h3>
680
+ <p class="text-xs text-slate-400 leading-relaxed">
681
+ Viết thuần TypeScript với <code>UI.*</code> và truyền mảng style có điều kiện tương tự React Native <code>StyleSheet</code> (<code>[styles.base, isAlert &amp;&amp; styles.alert]</code>). Tương thích mọi bundler không dùng JSX transform.
682
+ </p>
683
+ <div class="relative">
684
+ <button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
685
+ <pre><code class="language-typescript">import { UI, Widget } from 'react-native-live-widgets';
686
+
687
+ const styles = UI.StyleSheet.create({
688
+ card: { padding: 14, backgroundColor: '#111827', borderRadius: 16, spacing: 6 },
689
+ label: { fontSize: 13, fontWeight: 'medium', color: '#E2E8F0' },
690
+ errorText: { color: '#F87171', fontWeight: 'bold' },
691
+ });
692
+
693
+ const isLate = true;
694
+
695
+ await Widget.setLayout('shift', {
696
+ medium: UI.VStack(
697
+ styles.card,
698
+ UI.Text('TIÊU ĐỀ BÁO CÁO', { typography: 'caption1', color: '#94A3B8' }),
699
+ UI.Text('Trạng thái ca làm', [styles.label, isLate &amp;&amp; styles.errorText])
700
+ ),
701
+ });</code></pre>
702
+ </div>
703
+ </div>
704
+ </div>
705
+
706
+ <!-- WidgetPreview Card -->
707
+ <div id="widget-preview-comp" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-5 shadow-lg">
708
+ <div class="flex flex-wrap items-center justify-between gap-2">
709
+ <h3 class="font-bold text-white text-lg flex items-center space-x-2">
710
+ <i data-lucide="eye" class="w-5 h-5 text-sky-400"></i>
711
+ <span>Mô phỏng trực tiếp trong App: <code>&lt;WidgetPreview&gt;</code> (alias <code>&lt;VoltraWidgetPreview&gt;</code>)</span>
712
+ </h3>
713
+ <span class="text-xs bg-sky-500/10 text-sky-300 px-2.5 py-1 rounded-full border border-sky-500/20 font-semibold">
714
+ Multi-page &amp; Timer Preview
715
+ </span>
716
+ </div>
717
+ <p class="text-sm text-slate-300 leading-relaxed">
718
+ Nhúng thẳng giao diện Widget vào màn hình React Native để xem trước chính xác tỉ lệ chuẩn iOS/Android, tự động chuyển đổi trang (<code>page:*</code>), bật/tắt công tắc <code>toggle:*</code>, và chạy đồng hồ đếm ngược <code>PreviewTimerText</code> 1 giây/lần trước khi ghim ra màn hình chính.
719
+ </p>
720
+
721
+ <div class="overflow-x-auto">
722
+ <table class="w-full text-left text-xs sm:text-sm border-collapse">
723
+ <thead>
724
+ <tr class="border-b border-cardBorder text-slate-400">
725
+ <th class="py-2 pr-4 font-semibold">Prop</th>
726
+ <th class="py-2 pr-4 font-semibold">Kiểu</th>
727
+ <th class="py-2 font-semibold">Mô tả</th>
728
+ </tr>
729
+ </thead>
730
+ <tbody class="divide-y divide-cardBorder text-slate-300">
731
+ <tr>
732
+ <td class="py-2 pr-4 font-mono text-sky-400">size</td>
733
+ <td class="py-2 pr-4 font-mono text-xs text-slate-400">'small' | 'medium' | 'large' | 'extraLarge' | 'standBy' | 'lockScreen' | 'dynamicIsland' | 'control'</td>
734
+ <td class="py-2">Kích thước khung xem trước (mặc định <code>'medium'</code> 338×158dp). Hỗ trợ StandBy, ExtraLarge &amp; Control Tile (170×76dp).</td>
735
+ </tr>
736
+ <tr>
737
+ <td class="py-2 pr-4 font-mono text-sky-400">layout / controlConfig / children</td>
738
+ <td class="py-2 pr-4 font-mono text-xs text-slate-400">LayoutNode | WidgetSinglePageConfig | ControlWidgetConfig | ReactNode</td>
739
+ <td class="py-2">Nhận cây JSON DSL, object đa kích cỡ, cấu hình <code>ControlWidget</code> (kèm <code>size="control"</code>), hoặc thẻ JSX lồng trực tiếp.</td>
740
+ </tr>
741
+ <tr>
742
+ <td class="py-2 pr-4 font-mono text-sky-400">showBadge</td>
743
+ <td class="py-2 pr-4 font-mono text-xs text-slate-400">boolean (true)</td>
744
+ <td class="py-2">Hiển thị nhãn kích thước chuẩn ở góc trên.</td>
745
+ </tr>
746
+ <tr>
747
+ <td class="py-2 pr-4 font-mono text-sky-400">interactiveSizeSwitch</td>
748
+ <td class="py-2 pr-4 font-mono text-xs text-slate-400">boolean (false)</td>
749
+ <td class="py-2">Hiển thị thanh chuyển nhanh giữa Small / Medium / Large / Lock Screen.</td>
750
+ </tr>
751
+ <tr>
752
+ <td class="py-2 pr-4 font-mono text-sky-400">onAction</td>
753
+ <td class="py-2 pr-4 font-mono text-xs text-slate-400">(actionId: string) =&gt; void</td>
754
+ <td class="py-2">Nhận sự kiện khi bấm nút hoặc toggle bên trong khung xem trước.</td>
755
+ </tr>
756
+ </tbody>
757
+ </table>
758
+ </div>
759
+
760
+ <div class="relative">
761
+ <button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
762
+ <pre><code class="language-tsx">import React from 'react';
763
+ import { View } from 'react-native';
764
+ import { WidgetPreview, VStack, HStack, Text, Badge, Button } from 'react-native-live-widgets';
765
+
766
+ export default function PreviewScreen() {
767
+ return (
768
+ &lt;View style={{ flex: 1, padding: 16 }}&gt;
769
+ &lt;WidgetPreview
770
+ size="medium"
771
+ showBadge
772
+ interactiveSizeSwitch
773
+ onAction={(actionId) =&gt; console.log('Action clicked in preview:', actionId)}
774
+ &gt;
775
+ &lt;VStack padding={16} backgroundColor="#0F172A" borderRadius={18} spacing={8}&gt;
776
+ &lt;HStack justifyContent="spaceBetween" alignment="center"&gt;
777
+ &lt;Text fontSize={15} fontWeight="bold" color="#FFFFFF"&gt;Ca Làm Việc Hôm Nay&lt;/Text&gt;
778
+ &lt;Badge text="08:00 - 17:30" backgroundColor="#064E3B" textColor="#6EE7B7" /&gt;
779
+ &lt;/HStack&gt;
780
+ &lt;Text fontSize={13} color="#94A3B8"&gt;Vị trí: Văn phòng Fastdo Đà Nẵng&lt;/Text&gt;
781
+ &lt;Button
782
+ title="⚡ Check-in Ngay"
783
+ actionId="FASTDO_CHECKIN"
784
+ backgroundColor="#0284C7"
785
+ textColor="#FFFFFF"
786
+ /&gt;
787
+ &lt;/VStack&gt;
788
+ &lt;/WidgetPreview&gt;
789
+ &lt;/View&gt;
790
+ );
791
+ }</code></pre>
792
+ </div>
793
+ </div>
794
+ </section>
795
+
796
+ <!-- Section: Exact Dynamic Hit Layer & Chronometer Countdown (v1.2.1) -->
797
+ <section id="exact-hit-layer" class="space-y-6">
798
+ <div class="border-b border-cardBorder pb-4">
799
+ <div class="flex items-center space-x-2">
800
+ <span class="px-2.5 py-0.5 rounded-full text-xs font-bold bg-emerald-500/20 text-emerald-300 border border-emerald-500/30 uppercase">v1.2.1 Mới</span>
801
+ <h2 class="text-2xl sm:text-3xl font-extrabold text-white">
802
+ Vùng Bấm Động Từng Pixel, Chronometer &amp; Swift 6 Ready
803
+ </h2>
804
+ </div>
805
+ <p class="mt-2 text-slate-400 text-sm sm:text-base leading-relaxed">
806
+ Bản phát hành <strong>v1.2.1</strong> tái cấu trúc toàn diện hệ thống tương tác cảm ứng trên Android Home Screen Widgets, tích hợp đồng hồ đếm ngược phần cứng native và tương thích hoàn toàn <strong>Swift 6 Language Mode</strong> trên Xcode mới.
807
+ </p>
808
+ </div>
809
+
810
+ <div class="grid grid-cols-1 md:grid-cols-2 gap-6">
811
+ <div class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-3">
812
+ <h3 class="font-bold text-white text-base flex items-center space-x-2">
813
+ <i data-lucide="crosshair" class="w-5 h-5 text-emerald-400"></i>
814
+ <span>1. Exact Dynamic Hit Layer (<code>rn_hit_layer</code>)</span>
815
+ </h3>
816
+ <p class="text-xs sm:text-sm text-slate-400 leading-relaxed">
817
+ Thay thế hoàn toàn lưới cố định cũ bằng <code>FrameLayout</code> động (<code>rn_live_widget_hit_zone.xml</code>). Giải thuật <code>computeCanvasMapping</code> ánh xạ chính xác toạ độ từ Bitmap Canvas sang khung Launcher thật (xử lý bù viền <code>fitCenter</code> letterboxing). Bấm vào nút/checkbox nào ăn đúng 100% nút đó, vùng trống hoàn toàn không kích hoạt nhầm.
818
+ </p>
819
+ </div>
820
+
821
+ <div class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-3">
822
+ <h3 class="font-bold text-white text-base flex items-center space-x-2">
823
+ <i data-lucide="timer" class="w-5 h-5 text-sky-400"></i>
824
+ <span>2. Native Chronometer Countdown (Android)</span>
825
+ </h3>
826
+ <p class="text-xs sm:text-sm text-slate-400 leading-relaxed">
827
+ Tích hợp trực tiếp <code>android.widget.Chronometer</code> với <code>setChronometerCountDown(true)</code> và <code>baseMillis = SystemClock.elapsedRealtime() + remainingMillis</code>. Khi có timer đếm ngược, hệ thống ẩn text tĩnh trên Bitmap để đồng hồ native tự chạy giật lùi 1s/lần mà không phải vẽ lại ảnh Canvas.
828
+ </p>
829
+ </div>
830
+
831
+ <div class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-3">
832
+ <h3 class="font-bold text-white text-base flex items-center space-x-2">
833
+ <i data-lucide="brackets" class="w-5 h-5 text-amber-400"></i>
834
+ <span>3. Nội suy Biến động &amp; <code>defaultChecked</code> Store</span>
835
+ </h3>
836
+ <p class="text-xs sm:text-sm text-slate-400 leading-relaxed">
837
+ <code>DynamicWidgetStateStore</code> hỗ trợ nội suy chuỗi mẫu <code>{{id}}</code>, <code>{{title}}</code>, giá trị bộ đếm phẳng và tự động lưu trạng thái khởi tạo <code>defaultChecked</code> của công tắc <code>checked: true</code> ngay lần render đầu, giúp tắt công tắc mượt mà ngay lần chạm đầu tiên.
838
+ </p>
839
+ </div>
840
+
841
+ <div class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-3">
842
+ <h3 class="font-bold text-white text-base flex items-center space-x-2">
843
+ <i data-lucide="shield-check" class="w-5 h-5 text-purple-400"></i>
844
+ <span>4. Tương thích Swift 6 Language Mode (iOS)</span>
845
+ </h3>
846
+ <p class="text-xs sm:text-sm text-slate-400 leading-relaxed">
847
+ Khắc phục lỗi biên dịch <code>type '()' cannot conform to 'View'</code> trên Xcode mới bằng cách đóng gói closure cho <code>Font</code> trong <code>renderText()</code>, tách logic accessibility sang hàm thuần <code>buildAccessibilityView(content:) -&gt; AnyView</code>, và bổ sung <code>EmptyView()</code> cho các nhánh <code>ContainerStyleModifier</code>.
848
+ </p>
849
+ </div>
850
+ </div>
851
+ </section>
852
+
853
+ <!-- Section: Declarative UI Catalog -->
854
+ <section id="dsl-catalog" class="space-y-8">
855
+ <div class="border-b border-cardBorder pb-4">
856
+ <h2 class="text-2xl sm:text-3xl font-extrabold text-white flex items-center space-x-2.5">
857
+ <i data-lucide="boxes" class="w-7 h-7 text-sky-400"></i>
858
+ <span>Declarative UI Engine Catalog (JSX &amp; <code>UI.*</code>)</span>
859
+ </h2>
860
+ <p class="mt-2 text-slate-400 text-sm sm:text-base">
861
+ Toàn bộ hệ sinh thái component khai báo có TypeScript autocompletion đầy đủ và ánh xạ tương đương sang SwiftUI (iOS) &amp; 2D Canvas / RemoteViews (Android).
862
+ </p>
863
+ </div>
864
+
865
+ <!-- 1. Layout Containers -->
866
+ <div id="dsl-containers" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
867
+ <div class="flex flex-wrap items-center justify-between gap-2">
868
+ <h3 class="font-bold text-white text-lg flex items-center space-x-2">
869
+ <i data-lucide="layout-grid" class="w-5 h-5 text-sky-400"></i>
870
+ <span>Bố cục: <code>VStack</code>, <code>HStack</code>, <code>ZStack</code>, <code>Grid</code>, <code>Spacer</code> &amp; <code>Divider</code></span>
871
+ </h3>
872
+ <span class="text-xs bg-sky-500/10 text-sky-300 px-2.5 py-0.5 rounded-full font-mono">ContainerProps</span>
873
+ </div>
874
+ <p class="text-xs sm:text-sm text-slate-300 leading-relaxed">
875
+ Hỗ trợ xếp dọc (<code>VStack</code>), xếp ngang (<code>HStack</code>), xếp chồng lớp (<code>ZStack</code>), chia lưới nhiều cột đều nhau (<code>Grid</code>), khoảng trống co giãn (<code>Spacer</code>) và đường kẻ phân cách (<code>Divider</code>). Hỗ trợ các thuộc tính: <code>padding</code>, <code>paddingHorizontal</code>, <code>paddingVertical</code>, <code>spacing</code> (alias <code>gap</code>), <code>alignment</code>, <code>justifyContent</code>, <code>backgroundColor</code>, <code>gradient</code>, <code>borderRadius</code> (alias <code>cornerRadius</code>), <code>borderWidth</code>, <code>borderColor</code>, <code>borderStyle</code>.
876
+ </p>
877
+ <div class="relative">
878
+ <button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
879
+ <pre><code class="language-typescript">UI.VStack(
880
+ { padding: 14, backgroundColor: '#1A1D24', borderRadius: 16, spacing: 10 },
881
+ // 1. ZStack: Xếp chồng chấm trạng thái lên góc phải dưới Avatar
882
+ UI.HStack(
883
+ { spacing: 10, alignment: 'center' },
884
+ UI.ZStack(
885
+ { zAlignment: 'bottomTrailing' },
886
+ UI.Image({ url: 'https://example.com/avatar.jpg', width: 44, height: 44, borderRadius: 22 }),
887
+ UI.Badge('●', { backgroundColor: '#10B981', textColor: '#FFFFFF', fontSize: 8 })
888
+ ),
889
+ UI.VStack(
890
+ { spacing: 2 },
891
+ UI.Text('Nguyễn Văn A', { fontWeight: 'bold', color: '#FFFFFF' }),
892
+ UI.Text('Đang trực tuyến', { fontSize: 11, color: '#94A3B8' })
893
+ ),
894
+ UI.Spacer()
895
+ ),
896
+ UI.Divider({ color: '#334155', thickness: 1, marginVertical: 2 }),
897
+ // 2. Grid: Chia lưới 2 cột đều nhau cho bảng chỉ số KPI
898
+ UI.Grid(
899
+ { columns: 2, columnSpacing: 8, rowSpacing: 8 },
900
+ UI.VStack(
901
+ { padding: 8, backgroundColor: '#1E293B', borderRadius: 8 },
902
+ UI.Text('Doanh thu', { fontSize: 10, color: '#94A3B8' }),
903
+ UI.Text('4.85 Tỷ', { fontSize: 14, fontWeight: 'bold', color: '#FFFFFF' })
904
+ ),
905
+ UI.VStack(
906
+ { padding: 8, backgroundColor: '#1E293B', borderRadius: 8 },
907
+ UI.Text('Đơn hàng', { fontSize: 10, color: '#94A3B8' }),
908
+ UI.Text('1,420', { fontSize: 14, fontWeight: 'bold', color: '#34D399' })
909
+ )
910
+ )
911
+ )</code></pre>
912
+ </div>
913
+ </div>
914
+
915
+ <!-- 2. Text & Badge -->
916
+ <div id="dsl-text-badge" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
917
+ <div class="flex flex-wrap items-center justify-between gap-2">
918
+ <h3 class="font-bold text-white text-lg flex items-center space-x-2">
919
+ <i data-lucide="type" class="w-5 h-5 text-emerald-400"></i>
920
+ <span>Văn bản &amp; Nhãn: <code>UI.Text</code>, <code>UI.Badge</code> &amp; Nội suy <code>{{field}}</code></span>
921
+ </h3>
922
+ <span class="text-xs bg-emerald-500/10 text-emerald-300 px-2.5 py-0.5 rounded-full font-mono">TextStyle</span>
923
+ </div>
924
+ <p class="text-xs sm:text-sm text-slate-300 leading-relaxed">
925
+ <code>UI.Text</code> tự động thay thế biến động <code>{{checkinTime}}</code>, <code>{{id}}</code>, <code>{{title}}</code>, <code>{{_lastSyncTime}}</code> từ API ngầm/State Store, hỗ trợ <code>typography</code> chuẩn Apple HIG/Material (<code>largeTitle</code> &rarr; <code>caption2</code>), <code>fontDesign</code> (<code>monospaced</code>, <code>rounded</code>, <code>serif</code>), <code>numericAnimation</code> (cuộn số iOS 16+), <code>strikethroughWhenToggled</code>, và <code>privacySensitive</code> / <code>redacted</code>.
926
+ </p>
927
+ <div class="relative">
928
+ <button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
929
+ <pre><code class="language-typescript">UI.HStack(
930
+ { justifyContent: 'spaceBetween', alignment: 'center' },
931
+ UI.Text('Mã #{{id}} • Check-in {{checkinTime}}', {
932
+ color: { light: '#0F172A', dark: '#F8FAFC', tinted: '#38BDF8' },
933
+ typography: 'subheadline',
934
+ fontDesign: 'monospaced',
935
+ numberOfLines: 1,
936
+ strikethroughWhenToggled: 'task_1',
937
+ privacySensitive: true,
282
938
  }),
939
+ UI.Badge('+18% KPI', {
940
+ systemName: 'arrow.up.right',
941
+ backgroundColor: '#064E3B',
942
+ textColor: '#34D399',
943
+ fontSize: 10,
944
+ borderRadius: 999,
945
+ })
946
+ )</code></pre>
947
+ </div>
948
+ </div>
949
+
950
+ <!-- 3. Image & System Icons (Apple SF Symbols + Google Material Icons) -->
951
+ <div id="dsl-image" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
952
+ <div class="flex flex-wrap items-center justify-between gap-2">
953
+ <h3 class="font-bold text-white text-lg flex items-center space-x-2">
954
+ <i data-lucide="image" class="w-5 h-5 text-pink-400"></i>
955
+ <span data-i18n="dsl_image_title">Hình ảnh &amp; Biểu tượng Hệ thống: <code>UI.Image</code> &amp; <code>&lt;Image&gt;</code></span>
956
+ </h3>
957
+ <div class="flex items-center space-x-2">
958
+ <span class="text-xs bg-pink-500/10 text-pink-300 px-2.5 py-0.5 rounded-full font-mono">Auto-Cache 360px</span>
959
+ <span class="text-xs bg-emerald-500/10 text-emerald-300 px-2.5 py-0.5 rounded-full font-mono">13,000+ Icons</span>
960
+ </div>
961
+ </div>
962
+
963
+ <p data-i18n="dsl_image_desc" class="text-xs sm:text-sm text-slate-300 leading-relaxed">
964
+ Hỗ trợ <strong>5 nguồn ảnh</strong>: <code>url</code> (tự tải ngầm, nén tối đa 360px tránh vượt ngưỡng 30MB WidgetKit và lưu vào App Group cache), <code>base64</code> (QR/Barcode), <code>systemName</code>, <code>assetName</code>, và <code>filePath</code>.
965
+ Đặc biệt hỗ trợ icon hệ thống đa nền tảng chuyên biệt: <code>systemNameIos</code> (Apple SF Symbols) và <code>systemNameAndroid</code> (Google Material Icons) với gợi ý type IntelliSense đầy đủ.
966
+ </p>
967
+
968
+ <!-- Official Icon Catalog Links -->
969
+ <div class="grid grid-cols-1 sm:grid-cols-2 gap-3 pt-1">
970
+ <a href="https://developer.apple.com/sf-symbols/" target="_blank" class="p-3 rounded-xl bg-slate-900/90 border border-slate-700/80 hover:border-sky-500/50 hover:bg-slate-800/80 transition flex items-center justify-between group">
971
+ <div class="flex items-center space-x-3">
972
+ <div class="w-9 h-9 rounded-lg bg-sky-500/10 text-sky-400 flex items-center justify-center font-bold text-lg">
973
+ 🍏
974
+ </div>
975
+ <div>
976
+ <h4 class="text-xs font-bold text-white group-hover:text-sky-300 transition">Apple SF Symbols Catalog</h4>
977
+ <p class="text-[11px] text-slate-400">9,500+ biểu tượng vector native iOS</p>
978
+ </div>
979
+ </div>
980
+ <span class="text-xs text-sky-400 group-hover:translate-x-0.5 transition font-semibold">Tra cứu ↗</span>
981
+ </a>
982
+
983
+ <a href="https://fonts.google.com/icons" target="_blank" class="p-3 rounded-xl bg-slate-900/90 border border-slate-700/80 hover:border-emerald-500/50 hover:bg-slate-800/80 transition flex items-center justify-between group">
984
+ <div class="flex items-center space-x-3">
985
+ <div class="w-9 h-9 rounded-lg bg-emerald-500/10 text-emerald-400 flex items-center justify-center font-bold text-lg">
986
+ 🤖
987
+ </div>
988
+ <div>
989
+ <h4 class="text-xs font-bold text-white group-hover:text-emerald-300 transition">Google Material Icons Catalog</h4>
990
+ <p class="text-[11px] text-slate-400">3,800+ vector glyphs Android (snake/kebab)</p>
991
+ </div>
992
+ </div>
993
+ <span class="text-xs text-emerald-400 group-hover:translate-x-0.5 transition font-semibold">Tra cứu ↗</span>
994
+ </a>
995
+ </div>
996
+
997
+ <div class="relative">
998
+ <button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
999
+ <pre><code class="language-typescript">// 1. Ảnh Avatar từ URL mạng có viền &amp; icon dự phòng
1000
+ UI.Image({
1001
+ url: 'https://images.unsplash.com/photo-1534528741775-53994a69daeb?w=300&amp;q=80',
1002
+ fallbackSystemName: 'person.crop.circle.fill',
1003
+ width: 44,
1004
+ height: 44,
1005
+ cornerRadius: 999,
1006
+ contentMode: 'fill',
1007
+ borderColor: '#60A5FA',
1008
+ borderWidth: 2,
1009
+ })
1010
+
1011
+ // 2. Icon hệ thống đa nền tảng (Apple SF Symbols + Google Material Icons)
1012
+ UI.Image({
1013
+ systemNameIos: 'bolt.horizontal.fill', // 9,500+ Apple SF Symbols
1014
+ systemNameAndroid: 'bolt', // 3,800+ Google Material Icons
1015
+ tintColor: '#10B981',
1016
+ width: 24,
1017
+ height: 24,
1018
+ })
1019
+
1020
+ // 3. Hoặc sử dụng dạng JSX React Component:
1021
+ &lt;Image
1022
+ systemNameIos="person.crop.circle.badge.checkmark"
1023
+ systemNameAndroid="verified_user"
1024
+ tintColor="#10B981"
1025
+ width={24}
1026
+ height={24}
1027
+ /&gt;</code></pre>
1028
+ </div>
1029
+ </div>
1030
+
1031
+ <!-- 4. Timer, Equalizer, Progress grid -->
1032
+ <div class="grid grid-cols-1 md:grid-cols-2 gap-6">
1033
+
1034
+ <!-- UI.Timer -->
1035
+ <div id="dsl-timer" class="bg-darkCard border border-cardBorder rounded-2xl p-5 space-y-3">
1036
+ <div class="flex items-center justify-between">
1037
+ <span class="font-bold text-white text-base flex items-center space-x-2">
1038
+ <i data-lucide="clock" class="w-4 h-4 text-sky-400"></i>
1039
+ <span>UI.Timer — Đếm giờ Phần cứng</span>
1040
+ </span>
1041
+ <span class="text-[10px] text-sky-400 bg-sky-500/10 px-2 py-0.5 rounded font-mono">0% CPU</span>
1042
+ </div>
1043
+ <p class="text-xs text-slate-400 leading-relaxed">
1044
+ Nhận <code>targetTimestamp</code> (epoch <strong>giây</strong>), tự đếm lùi (<code>countdown</code>) bằng SwiftUI timer trên iOS và native <code>android.widget.Chronometer</code> trên Android:
1045
+ </p>
1046
+ <div class="relative">
1047
+ <button onclick="copyCode(this)" class="absolute top-2 right-2 text-xs bg-slate-800 text-slate-300 px-2 py-0.5 rounded">Copy</button>
1048
+ <pre><code class="language-typescript">const targetSec = Math.floor(Date.now() / 1000) + 25 * 60;
1049
+
1050
+ UI.Timer(targetSec, {
1051
+ mode: 'countdown', // 'countdown' | 'countup'
1052
+ color: '#38BDF8',
1053
+ fontSize: 28,
1054
+ fontWeight: 'bold',
1055
+ prefix: 'Còn ',
1056
+ suffix: ' phút',
1057
+ })</code></pre>
1058
+ </div>
1059
+ </div>
1060
+
1061
+ <!-- UI.Equalizer -->
1062
+ <div id="dsl-equalizer" class="bg-darkCard border border-cardBorder rounded-2xl p-5 space-y-3">
1063
+ <div class="flex items-center justify-between">
1064
+ <span class="font-bold text-white text-base flex items-center space-x-2">
1065
+ <i data-lucide="activity" class="w-4 h-4 text-purple-400"></i>
1066
+ <span>UI.Equalizer — Sóng nhạc liên tục</span>
1067
+ </span>
1068
+ <span class="text-[10px] text-purple-400 bg-purple-500/10 px-2 py-0.5 rounded font-mono">Realtime</span>
1069
+ </div>
1070
+ <p class="text-xs text-slate-400 leading-relaxed">
1071
+ Hiển thị sóng âm thanh chuyển động cho audio/podcast qua <code>phase</code> hoặc mảng biên độ <code>levels</code> (0..1):
1072
+ </p>
1073
+ <div class="relative">
1074
+ <button onclick="copyCode(this)" class="absolute top-2 right-2 text-xs bg-slate-800 text-slate-300 px-2 py-0.5 rounded">Copy</button>
1075
+ <pre><code class="language-typescript">UI.Equalizer({
1076
+ isPlaying: true,
1077
+ barCount: 5,
1078
+ tintColor: '#A855F7',
1079
+ height: 20,
1080
+ barWidth: 3,
1081
+ spacing: 2,
1082
+ phase: 1, // Hoặc levels: [0.3, 0.8, 0.5, 0.9, 0.4]
1083
+ })</code></pre>
1084
+ </div>
1085
+ </div>
1086
+
1087
+ <!-- UI.Progress -->
1088
+ <div id="dsl-progress" class="bg-darkCard border border-cardBorder rounded-2xl p-5 space-y-3 md:col-span-2">
1089
+ <div class="flex items-center justify-between">
1090
+ <span class="font-bold text-white text-base flex items-center space-x-2">
1091
+ <i data-lucide="bar-chart-2" class="w-4 h-4 text-emerald-400"></i>
1092
+ <span>UI.Progress — Bar, Segmented &amp; Circular + Tracker &amp; Smart Warning</span>
1093
+ </span>
1094
+ <span class="text-[10px] text-emerald-400 bg-emerald-500/10 px-2 py-0.5 rounded font-mono">ProgressStyle</span>
1095
+ </div>
1096
+ <p class="text-xs text-slate-400 leading-relaxed">
1097
+ Hỗ trợ 3 kiểu dáng (<code>'bar'</code>, <code>'segmented'</code>, <code>'circular'</code>), tự chạy theo <code>startTimestamp</code>/<code>targetTimestamp</code>, đổi màu cảnh báo khi sắp hết hạn (<code>warningSeconds</code>, <code>warningTintColor</code>), và gắn icon di chuyển theo đầu thanh (<code>trackerSystemName</code>).
1098
+ </p>
1099
+ <div class="relative">
1100
+ <button onclick="copyCode(this)" class="absolute top-2 right-2 text-xs bg-slate-800 text-slate-300 px-2 py-0.5 rounded">Copy</button>
1101
+ <pre><code class="language-typescript">// 1. Thanh chia 4 chặng (Segmented) cho giao hàng / ca làm
1102
+ UI.Progress({
1103
+ style: 'segmented',
1104
+ segments: 4,
1105
+ currentSegment: 3,
1106
+ segmentSpacing: 6,
1107
+ tintColor: '#10B981',
1108
+ trackColor: '#374151',
1109
+ height: 8,
1110
+ })
1111
+
1112
+ // 2. Vòng tròn tiến độ kèm cảnh báo đổi màu
1113
+ UI.Progress({
1114
+ style: 'circular',
1115
+ value: 0.75,
1116
+ tintColor: '#38BDF8',
1117
+ trackColor: '#1E293B',
1118
+ height: 56,
1119
+ showPercentage: true,
1120
+ })</code></pre>
1121
+ </div>
1122
+ </div>
1123
+ </div>
1124
+
1125
+ <!-- 5. Gauge & Chart -->
1126
+ <div id="dsl-gauge-chart" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
1127
+ <div class="flex flex-wrap items-center justify-between gap-2">
1128
+ <h3 class="font-bold text-white text-lg flex items-center space-x-2">
1129
+ <i data-lucide="gauge" class="w-5 h-5 text-cyan-400"></i>
1130
+ <span>Đồ họa Số liệu: <code>UI.Gauge</code> (240°) &amp; <code>UI.Chart</code> (Bar / Sparkline)</span>
1131
+ </h3>
1132
+ <span class="text-xs bg-cyan-500/10 text-cyan-300 px-2.5 py-0.5 rounded-full font-mono">Canvas Sub-renderer</span>
1133
+ </div>
1134
+ <p class="text-xs sm:text-sm text-slate-300 leading-relaxed">
1135
+ <code>UI.Gauge</code> vẽ đồng hồ cung tròn 240° hiển thị KPI/chỉ số sức khỏe; <code>UI.Chart</code> vẽ biểu đồ cột (<code>'bar'</code>) hoặc đường xu hướng Sparkline (<code>'line'</code>). Trên Android, chỉ phần hộp bao đồ họa được vẽ thành Sub-Bitmap nhỏ (~40KB RAM) để không chạm trần Binder IPC.
1136
+ </p>
1137
+ <div class="relative">
1138
+ <button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
1139
+ <pre><code class="language-typescript">// 1. Đồng hồ đo KPI cung tròn 240°
1140
+ UI.Gauge(0.86, {
1141
+ size: 66,
1142
+ strokeWidth: 7,
1143
+ tintColor: '#38BDF8',
1144
+ trackColor: '#1E293B',
1145
+ valueText: '86%',
1146
+ label: 'KPI Quý',
1147
+ })
1148
+
1149
+ // 2. Biểu đồ Cột / Đường xu hướng 7 ngày
1150
+ UI.Chart([42, 58, 51, 74, 68, 92, 108], {
1151
+ style: 'line', // 'bar' | 'line'
1152
+ labels: ['T2', 'T3', 'T4', 'T5', 'T6', 'T7', 'CN'],
1153
+ tintColor: '#38BDF8',
1154
+ secondaryColor: '#1E3A8A',
1155
+ height: 52,
1156
+ showDots: true,
1157
+ })</code></pre>
1158
+ </div>
1159
+ </div>
1160
+
1161
+ <!-- 6. Interactive: Button, Toggle, Link -->
1162
+ <div id="dsl-interactive" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
1163
+ <div class="flex flex-wrap items-center justify-between gap-2">
1164
+ <h3 class="font-bold text-white text-lg flex items-center space-x-2">
1165
+ <i data-lucide="mouse-pointer-click" class="w-5 h-5 text-amber-400"></i>
1166
+ <span>Tương tác: <code>UI.Button</code>, <code>UI.Toggle</code> (<code>&lt;Switch&gt;</code>/<code>&lt;Checkbox&gt;</code>) &amp; <code>UI.Link</code></span>
1167
+ </h3>
1168
+ <span class="text-xs bg-amber-500/10 text-amber-300 px-2.5 py-0.5 rounded-full font-mono">AppIntents + Exact Hit Layer</span>
1169
+ </div>
1170
+ <p class="text-xs sm:text-sm text-slate-300 leading-relaxed">
1171
+ Thư viện hỗ trợ các tiền tố <code>actionId</code> xử lý tự động ngay ở tầng Native mà không cần mở App:
1172
+ <code>page:&lt;id&gt;</code> / <code>page:next</code> / <code>page:prev</code> (lật trang Widget),
1173
+ <code>toggle:&lt;key&gt;</code> (đảo trạng thái tick/switch và lưu ngay vào <code>DynamicWidgetStateStore</code>),
1174
+ và <code>refresh</code> (kéo lại dữ liệu từ Remote API ngay lập tức).
1175
+ </p>
1176
+ <div class="relative">
1177
+ <button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
1178
+ <pre><code class="language-typescript">// 1. Nút chuyển trang hoặc Tick hoàn thành kèm đổi màu
1179
+ UI.Button({
1180
+ title: 'Duyệt PR chấm công',
1181
+ checkedTitle: '✓ Đã duyệt PR',
1182
+ actionId: 'toggle:task_1',
1183
+ backgroundColor: '#F8FAFC',
1184
+ checkedBackgroundColor: '#DCFCE7',
1185
+ textColor: '#1E293B',
1186
+ checkedTextColor: '#15803D',
1187
+ fullWidth: true,
1188
+ })
1189
+
1190
+ // 2. Toggle Checkbox hoặc Switch (JSX cũng có thẻ &lt;Checkbox /&gt;, &lt;Switch /&gt;)
1191
+ UI.Toggle('Tự động gửi cảnh báo vượt ngưỡng', {
1192
+ actionId: 'toggle:auto_alert',
1193
+ style: 'switch', // 'checkbox' | 'switch'
1194
+ checked: true,
1195
+ tintColor: '#10B981',
1196
+ strikethroughOnCheck: false,
1197
+ })
1198
+
1199
+ // 3. Link bọc khối giao diện mở Deep Link thẳng vào màn hình trong App
1200
+ UI.Link(
1201
+ { deepLink: 'fastdo://reports/q4', padding: 10, backgroundColor: '#1E293B', borderRadius: 10 },
1202
+ UI.Text('Xem chi tiết báo cáo →', { fontSize: 12, fontWeight: 'bold', color: '#38BDF8' })
1203
+ )</code></pre>
1204
+ </div>
1205
+ </div>
1206
+
1207
+ <!-- 7. UI.Custom & DynamicNodeRegistry -->
1208
+ <div id="dsl-custom" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
1209
+ <div class="flex flex-wrap items-center justify-between gap-2">
1210
+ <h3 class="font-bold text-white text-lg flex items-center space-x-2">
1211
+ <i data-lucide="puzzle" class="w-5 h-5 text-indigo-400"></i>
1212
+ <span>Mở rộng Component Native: <code>UI.Custom</code> &amp; <code>DynamicNodeRegistry</code></span>
1213
+ </h3>
1214
+ <span class="text-xs bg-indigo-500/10 text-indigo-300 px-2.5 py-0.5 rounded-full font-mono">SwiftUI &amp; Kotlin Canvas</span>
1215
+ </div>
1216
+ <p class="text-xs sm:text-sm text-slate-300 leading-relaxed">
1217
+ Khi cần nhúng đồ họa hoặc View Native đặc thù mà DSL chưa có sẵn, bạn đăng ký custom renderer trong <code>LiveWidgetsBundle.swift</code> (iOS) và <code>MainApplication.kt</code> (Android), rồi gọi qua <code>UI.Custom('WeatherCard', { ... })</code>.
1218
+ </p>
1219
+ <div class="grid grid-cols-1 lg:grid-cols-2 gap-4">
1220
+ <div class="relative">
1221
+ <button onclick="copyCode(this)" class="absolute top-2 right-2 text-xs bg-slate-800 text-slate-300 px-2 py-0.5 rounded">Copy</button>
1222
+ <pre><code class="language-swift">// iOS (LiveWidgetsBundle.swift)
1223
+ DynamicNodeRegistry.shared.registerView("WeatherCard") { node in
1224
+ let city = node.props?["city"]?.stringValue ?? "Hà Nội"
1225
+ let temp = node.props?["temp"]?.stringValue ?? "28°C"
1226
+ HStack {
1227
+ Image(systemName: "sun.max.fill").foregroundColor(.yellow)
1228
+ Text("\(city): \(temp)").font(.headline)
1229
+ }
1230
+ }</code></pre>
1231
+ </div>
1232
+ <div class="relative">
1233
+ <button onclick="copyCode(this)" class="absolute top-2 right-2 text-xs bg-slate-800 text-slate-300 px-2 py-0.5 rounded">Copy</button>
1234
+ <pre><code class="language-kotlin">// Android (MainApplication.onCreate)
1235
+ DynamicNodeRegistry.register(
1236
+ componentName = "WeatherCard",
1237
+ heightDp = { 44f },
1238
+ drawer = { context, canvas, rect, props, density -&gt;
1239
+ // Vẽ tự do lên Android 2D Canvas
1240
+ }
1241
+ )</code></pre>
1242
+ </div>
1243
+ </div>
1244
+ </div>
1245
+
1246
+ <!-- 8. Styling Modifiers -->
1247
+ <div id="styling-modifiers" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
1248
+ <div class="flex flex-wrap items-center justify-between gap-2">
1249
+ <h3 class="font-bold text-white text-lg flex items-center space-x-2">
1250
+ <i data-lucide="palette" class="w-5 h-5 text-fuchsia-400"></i>
1251
+ <span>Styling Modifiers Nâng cao: Gradient, Border Nét Đứt, Shadow, Tinted &amp; RTL</span>
1252
+ </h3>
1253
+ <span class="text-xs bg-fuchsia-500/10 text-fuchsia-300 px-2.5 py-0.5 rounded-full font-mono">Graceful Fallback</span>
1254
+ </div>
1255
+ <p class="text-xs sm:text-sm text-slate-300 leading-relaxed">
1256
+ Nếu thiết bị hoặc phiên bản OS không hỗ trợ một hiệu ứng (ví dụ Gradient trên OS cũ), engine tự động hạ cấp an toàn (lấy màu đầu tiên làm nền đơn sắc) để không bao giờ vỡ giao diện.
1257
+ </p>
1258
+ <div class="relative">
1259
+ <button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
1260
+ <pre><code class="language-tsx">&lt;VStack
1261
+ gradient={{ colors: ['#1E3A8A', '#3B82F6'], startPoint: { x: 0, y: 0 }, endPoint: { x: 1, y: 1 } }}
1262
+ borderWidth={1.5}
1263
+ borderColor="#38BDF8"
1264
+ borderStyle="dashed" // 'solid' | 'dashed' | 'dotted'
1265
+ borderRadius={14}
1266
+ shadowColor="#2563EB"
1267
+ shadowRadius={6}
1268
+ shadowOpacity={0.35}
1269
+ shadowOffset={{ x: 0, y: 3 }}
1270
+ direction="ltr" // Hỗ trợ 'rtl' (isRTL: true)
1271
+ padding={16}
1272
+ &gt;
1273
+ &lt;Text color={{ light: '#0F172A', dark: '#F8FAFC', tinted: '#38BDF8' }} typography="headline"&gt;
1274
+ Tự động đổi màu theo Light / Dark / iOS 18 Tinted Mode
1275
+ &lt;/Text&gt;
1276
+ &lt;/VStack&gt;</code></pre>
1277
+ </div>
1278
+ </div>
1279
+ </section>
1280
+
1281
+ <!-- Section: Core API Reference -->
1282
+ <section id="core-api" class="space-y-6">
1283
+ <div class="border-b border-cardBorder pb-4">
1284
+ <h2 class="text-2xl sm:text-3xl font-extrabold text-white flex items-center space-x-2.5">
1285
+ <i data-lucide="book-marked" class="w-7 h-7 text-sky-400"></i>
1286
+ <span>Core API Reference</span>
1287
+ </h2>
1288
+ <p class="mt-2 text-slate-400 text-sm sm:text-base">
1289
+ Chi tiết toàn bộ API điều khiển <code>LiveActivity</code>, <code>Widget</code>, React Hooks, <code>SharedStorage</code>, Remote API Sync và Push Notifications.
1290
+ </p>
1291
+ </div>
1292
+
1293
+ <!-- LiveActivity API -->
1294
+ <div id="api-liveactivity" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-5">
1295
+ <div class="flex items-center justify-between">
1296
+ <h3 class="text-lg font-bold text-white">1. <code>LiveActivity</code> API &amp; Dynamic Island (iOS 16.1+ &amp; Android 16)</h3>
1297
+ <span class="text-xs bg-sky-500/10 text-sky-400 border border-sky-500/20 px-2.5 py-1 rounded-full">ActivityKit + ProgressStyle</span>
1298
+ </div>
1299
+
1300
+ <div class="overflow-x-auto">
1301
+ <table class="w-full text-left text-xs sm:text-sm border-collapse">
1302
+ <thead>
1303
+ <tr class="border-b border-cardBorder text-slate-400">
1304
+ <th class="py-2.5 pr-3 font-semibold">Hàm</th>
1305
+ <th class="py-2.5 pr-3 font-semibold">Tham số</th>
1306
+ <th class="py-2.5 font-semibold">Mô tả</th>
1307
+ </tr>
1308
+ </thead>
1309
+ <tbody class="divide-y divide-cardBorder text-slate-300">
1310
+ <tr>
1311
+ <td class="py-2.5 pr-3 font-mono text-sky-400 font-medium">LiveActivity.start(options)</td>
1312
+ <td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">StartActivityOptions</td>
1313
+ <td class="py-2.5">Bắt đầu Live Activity (iOS Lock Screen + Dynamic Island) hoặc Promoted Live Update Notification (Android).</td>
1314
+ </tr>
1315
+ <tr>
1316
+ <td class="py-2.5 pr-3 font-mono text-sky-400 font-medium">LiveActivity.update(options)</td>
1317
+ <td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">UpdateActivityOptions</td>
1318
+ <td class="py-2.5">Cập nhật layout, Dynamic Island, tiến trình hoặc pha theo <code>activityId</code>.</td>
1319
+ </tr>
1320
+ <tr>
1321
+ <td class="py-2.5 pr-3 font-mono text-sky-400 font-medium">LiveActivity.end(id, options?)</td>
1322
+ <td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">id, EndActivityOptions</td>
1323
+ <td class="py-2.5">Kết thúc Live Activity (chính sách đóng <code>dismissalPolicy</code>, hiển thị trạng thái cuối trước khi ẩn).</td>
1324
+ </tr>
1325
+ <tr>
1326
+ <td class="py-2.5 pr-3 font-mono text-sky-400 font-medium">LiveActivity.endAll()</td>
1327
+ <td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">none</td>
1328
+ <td class="py-2.5">Đóng toàn bộ các Live Activities đang hoạt động.</td>
1329
+ </tr>
1330
+ <tr>
1331
+ <td class="py-2.5 pr-3 font-mono text-sky-400 font-medium">LiveActivity.getActiveActivities() / get(id) / isActive(id)</td>
1332
+ <td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">id?: string</td>
1333
+ <td class="py-2.5">Quản lý nhiều phiên đồng thời: trả về <code>activityId</code>, <code>systemActivityId</code>, <code>isStale</code>, <code>relevanceScore</code>, <code>scheduledEndTimestamp</code>, <code>pushToken</code>.</td>
1334
+ </tr>
1335
+ <tr>
1336
+ <td class="py-2.5 pr-3 font-mono text-sky-400 font-medium">LiveActivity.onStateChange(listener) / cleanupExpired()</td>
1337
+ <td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">LiveActivityStateEvent</td>
1338
+ <td class="py-2.5">Lắng nghe chuyển đổi vòng đời (<code>active</code>, <code>started_by_push</code>, <code>stale</code>, <code>expired</code>, <code>ended</code>, <code>dismissed</code>) và tự động dọn dẹp phiên hết hạn.</td>
1339
+ </tr>
1340
+ <tr>
1341
+ <td class="py-2.5 pr-3 font-mono text-sky-400 font-medium">LiveActivity.areActivitiesEnabled() / canPostPromoted()</td>
1342
+ <td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">Promise&lt;boolean&gt;</td>
1343
+ <td class="py-2.5">Kiểm tra quyền hiển thị Live Activity (iOS) / Promoted Notification (Android 16).</td>
1344
+ </tr>
1345
+ <tr>
1346
+ <td class="py-2.5 pr-3 font-mono text-sky-400 font-medium">LiveActivity.registerBackgroundActionHandler(cb?)</td>
1347
+ <td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">HeadlessJs (Android)</td>
1348
+ <td class="py-2.5">Đăng ký trong <code>index.js</code> để xử lý sự kiện nút bấm ngay cả khi App Android đã bị tắt.</td>
1349
+ </tr>
1350
+ </tbody>
1351
+ </table>
1352
+ </div>
1353
+
1354
+ <div class="relative">
1355
+ <button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
1356
+ <pre><code class="language-typescript">// Cấu hình Dynamic Island + Stale UI + RelevanceScore + Auto Scheduled End
1357
+ await LiveActivity.start({
1358
+ activityId: 'shift_01',
1359
+ lockScreen: lockScreenCardNode,
1360
+ staleLockScreen: staleFallbackNode,
1361
+ staleTimestamp: shiftEndSec - 120,
1362
+ scheduledEndTimestamp: shiftEndSec,
1363
+ expiredLockScreen: completedSummaryNode,
1364
+ expiredDismissalPolicy: 'default',
1365
+ relevanceScore: 95,
1366
+ alertConfig: { title: 'Bắt đầu ca làm', body: 'Ca hành chính đã kích hoạt!', sound: 'default' },
283
1367
  dynamicIsland: {
284
- compactLeading: UI.Text('☕', { fontSize: 13 }),
285
- compactTrailing: UI.Text('12m', { color: '#38BDF8', fontWeight: 'bold' }),
1368
+ compactLeading: UI.HStack({ spacing: 4 }, avatarImg, UI.Text('08:02', { fontSize: 12, color: '#60A5FA' })),
1369
+ compactTrailing: UI.Timer(shiftEndSec, { mode: 'countdown', fontSize: 12, color: '#60A5FA' }),
1370
+ minimal: UI.Image({ systemName: 'clock.fill', tintColor: '#60A5FA', width: 14, height: 14 }),
286
1371
  expanded: {
287
- leading: UI.Text('COFFEE EXPRESS', { fontSize: 11 }),
288
- trailing: UI.Text('12 mins', { fontSize: 16, fontWeight: 'bold' })
289
- }
290
- }
1372
+ leading: UI.Text('ĐANG TRONG CA', { color: '#60A5FA', fontSize: 12, fontWeight: 'bold' }),
1373
+ trailing: UI.Timer(shiftEndSec, { mode: 'countdown', color: '#FFFFFF', fontSize: 14 }),
1374
+ bottom: UI.Progress({ style: 'segmented', segments: 4, value: 0.75, tintColor: '#3B82F6', height: 6 }),
1375
+ },
1376
+ },
1377
+ phases: [
1378
+ { id: 'warning', triggerTimestamp: shiftEndSec - 300, alertTitle: 'Sắp hết ca!', alertBody: 'Còn 5 phút nữa.' },
1379
+ ],
291
1380
  });</code></pre>
292
1381
  </div>
1382
+ </div>
293
1383
 
294
- <!-- Card: Interactive Widget Example -->
295
- <div class="bg-cardBg border border-cardBorder rounded-xl p-4 space-y-3">
296
- <div class="flex items-center justify-between">
297
- <span class="text-sm font-semibold text-white">⚡ Home Screen Widget Tương Tác 2 Chiều</span>
298
- <span class="text-xs text-emerald-400 bg-emerald-500/10 px-2 py-0.5 rounded">AppIntents</span>
299
- </div>
300
- <pre><code class="language-typescript">// Cập nhật Home Screen Widget với nút bấm tương tác
301
- Widget.reload('main', {
302
- layout: UI.VStack({
303
- padding: 14,
304
- backgroundColor: '#0F172A',
305
- alignment: 'center',
306
- children: [
307
- UI.Text('BỘ ĐẾM TIỆN ÍCH', { color: '#94A3B8', fontSize: 11 }),
308
- UI.Text(`${counter}`, { color: '#38BDF8', fontSize: 32, fontWeight: 'heavy' }),
309
- UI.Button({
310
- title: '+1 TĂNG SỐ',
311
- actionId: 'INCREMENT',
312
- backgroundColor: '#0284C7',
313
- color: '#FFFFFF'
314
- })
315
- ]
316
- })
1384
+ <!-- Widget API -->
1385
+ <div id="api-widget" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-5">
1386
+ <div class="flex items-center justify-between">
1387
+ <h3 class="text-lg font-bold text-white">2. <code>Widget</code> API (Multi-Page, ExtraLarge, StandBy &amp; Control Center)</h3>
1388
+ <span class="text-xs bg-emerald-500/10 text-emerald-400 border border-emerald-500/20 px-2.5 py-1 rounded-full">WidgetKit + ControlWidget</span>
1389
+ </div>
1390
+
1391
+ <div class="overflow-x-auto">
1392
+ <table class="w-full text-left text-xs sm:text-sm border-collapse">
1393
+ <thead>
1394
+ <tr class="border-b border-cardBorder text-slate-400">
1395
+ <th class="py-2.5 pr-3 font-semibold">Hàm</th>
1396
+ <th class="py-2.5 pr-3 font-semibold">Tham số</th>
1397
+ <th class="py-2.5 font-semibold">Mô tả</th>
1398
+ </tr>
1399
+ </thead>
1400
+ <tbody class="divide-y divide-cardBorder text-slate-300">
1401
+ <tr>
1402
+ <td class="py-2.5 pr-3 font-mono text-emerald-400 font-medium">Widget.setLayout(key, config, appGroup?)</td>
1403
+ <td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">WidgetLayoutConfig (alias <code>Widget.update</code>)</td>
1404
+ <td class="py-2.5">Cập nhật giao diện cho <code>small</code>, <code>medium</code>, <code>large</code>, <code>extraLarge</code>, <code>standBy</code>, <code>pages</code> đa trang và 3 kích thước Lock Screen iOS (<code>accessoryRectangular</code>, <code>accessoryCircular</code>, <code>accessoryInline</code>).</td>
1405
+ </tr>
1406
+ <tr>
1407
+ <td class="py-2.5 pr-3 font-mono text-emerald-400 font-medium">ControlWidget.set(id, cfg) / Widget.setControl(id, cfg)</td>
1408
+ <td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">UI.ControlButton / UI.ControlToggle</td>
1409
+ <td class="py-2.5">Cấu hình nút/công tắc nhanh trong iOS 18 Control Center, Action Button &amp; Lock Screen (<code>DynamicControlWidget.swift</code>) và Android Quick Settings Tile (<code>DynamicQuickSettingsTileService.kt</code>). Hỗ trợ xem trước với <code>&lt;WidgetPreview size="control" /&gt;</code>.</td>
1410
+ </tr>
1411
+ <tr>
1412
+ <td class="py-2.5 pr-3 font-mono text-emerald-400 font-medium">Widget.reload(kind) / Widget.reloadAll()</td>
1413
+ <td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">kind: string</td>
1414
+ <td class="py-2.5">Yêu cầu OS vẽ lại timeline / giao diện widget ngay lập tức.</td>
1415
+ </tr>
1416
+ <tr>
1417
+ <td class="py-2.5 pr-3 font-mono text-emerald-400 font-medium">Widget.isPinSupported() / requestPin()</td>
1418
+ <td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">Android 8.0+</td>
1419
+ <td class="py-2.5">Mở hộp thoại hệ thống cho người dùng ghim Widget ra Home Screen ngay trong App.</td>
1420
+ </tr>
1421
+ <tr>
1422
+ <td class="py-2.5 pr-3 font-mono text-emerald-400 font-medium">Widget.getCapabilities()</td>
1423
+ <td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">Promise&lt;WidgetCapabilities&gt;</td>
1424
+ <td class="py-2.5">Kiểm tra thiết bị có hỗ trợ Dynamic Island, iOS 18 Tinted Mode, Interactive Intents...</td>
1425
+ </tr>
1426
+ <tr>
1427
+ <td class="py-2.5 pr-3 font-mono text-emerald-400 font-medium">Widget.inspectIR(layout) / compileIR(layout)</td>
1428
+ <td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">LayoutNode | SinglePageConfig</td>
1429
+ <td class="py-2.5">Phân tích cây UI Intermediate Representation, kế hoạch Native vs Canvas và tóm tắt TalkBack/VoiceOver.</td>
1430
+ </tr>
1431
+ </tbody>
1432
+ </table>
1433
+ </div>
1434
+
1435
+ <div class="relative">
1436
+ <button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
1437
+ <pre><code class="language-typescript">// Widget đa trang (Pages) + Lock Screen iOS 16+ + Ghim nhanh Android
1438
+ await Widget.setLayout('main', {
1439
+ initialPage: 'overview',
1440
+ pages: {
1441
+ overview: { small: overviewSmall, medium: overviewMedium, large: overviewLarge },
1442
+ tasks: { small: tasksSmall, medium: tasksMedium, large: tasksLarge },
1443
+ },
1444
+ accessoryRectangular: UI.Text('★ Công việc hôm nay: 3/5', { fontSize: 12, fontWeight: 'bold' }),
1445
+ accessoryCircular: UI.Gauge(0.6, { size: 44, valueText: '60%' }),
1446
+ accessoryInline: UI.Text('♪ Đang trong ca • 08:00 - 17:30'),
317
1447
  });
318
1448
 
319
- // Cách 1: Dùng React Hook (Khuyến nghị - An toàn tuyệt đối với Fast Refresh)
320
- useWidgetAction('INCREMENT', () => {
321
- setCounter(c => c + 1);
1449
+ if (await Widget.isPinSupported()) {
1450
+ await Widget.requestPin();
1451
+ }</code></pre>
1452
+ </div>
1453
+ </div>
1454
+
1455
+ <!-- React Hooks & SharedStorage -->
1456
+ <div id="api-hooks" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
1457
+ <div class="flex flex-wrap items-center justify-between gap-2">
1458
+ <h3 class="text-lg font-bold text-white">3. React Hooks (Fast Refresh Resilient) &amp; <code>SharedStorage</code></h3>
1459
+ <span class="text-xs bg-purple-500/10 text-purple-300 border border-purple-500/20 px-2.5 py-1 rounded-full">Hooks &amp; App Group</span>
1460
+ </div>
1461
+ <p class="text-xs sm:text-sm text-slate-300 leading-relaxed">
1462
+ Các Hook tự động dọn dẹp listener khi unmount và đồng bộ 2 chiều qua App Group (iOS) / SharedPreferences (Android). Với các nghiệp vụ quan trọng (như Chấm công) khi App bị người dùng Force-Kill, hãy dùng mô hình <strong>Offline-First State Queue</strong> qua <code>SharedStorage</code>.
1463
+ </p>
1464
+ <div class="relative">
1465
+ <button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
1466
+ <pre><code class="language-typescript">import {
1467
+ useWidgetAction, useLiveActivity, useWidgetState, SharedStorage
1468
+ } from 'react-native-live-widgets';
1469
+
1470
+ // 1. Lắng nghe bấm nút từ Widget / Dynamic Island (an toàn với Fast Refresh)
1471
+ useWidgetAction('INCREMENT', (actionId, payload) =&gt; {
1472
+ console.log('Clicked:', actionId, payload);
322
1473
  });
323
1474
 
324
- // Cách 2: Lắng nghe toàn cục Imperative
325
- Widget.onWidgetAction((actionId) => {
326
- if (actionId === 'INCREMENT') {
327
- setCounter(c => c + 1);
328
- }
329
- });</code></pre>
1475
+ // 2. Quản lý vòng đời Live Activity bằng Hook
1476
+ const { activityId, isActive, start, update, end } = useLiveActivity();
1477
+
1478
+ // 3. State đồng bộ 2 chiều với Native Store
1479
+ const [counter, setCounter, resetCounter] = useWidgetState('widget_counter', 0);
1480
+
1481
+ // 4. Đọc / ghi trực tiếp vào App Group / SharedPreferences
1482
+ await SharedStorage.set('pending_checkin', { timestamp: Date.now() }, 'group.com.yourapp');
1483
+ const saved = await SharedStorage.get('pending_checkin', 'group.com.yourapp');</code></pre>
330
1484
  </div>
1485
+ </div>
1486
+
1487
+ <!-- Remote API Sync & Background Data Engine 2.0 -->
1488
+ <div id="api-remote-sync" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-5">
1489
+ <div class="flex flex-wrap items-center justify-between gap-2">
1490
+ <h3 class="text-lg font-bold text-white">4. Background Data Engine 2.0 &amp; Structured Data Binding</h3>
1491
+ <span class="text-xs bg-indigo-500/10 text-indigo-300 border border-indigo-500/20 px-2.5 py-1 rounded-full">URLSession &amp; AlarmManager</span>
1492
+ </div>
1493
+ <p class="text-xs sm:text-sm text-slate-300 leading-relaxed">
1494
+ Hỗ trợ đầy đủ REST (<code>GET</code>/<code>POST</code>/<code>PUT</code> + <code>body</code>), <code>headers</code>, <code>timeoutMs</code>, <code>cacheTtlSeconds</code>, <code>enableETag</code> (gửi <code>If-None-Match</code> &amp; xử lý HTTP <code>304 Not Modified</code>), <code>maxRetries</code> / <code>retryDelayMs</code> (Exponential Backoff), đa nguồn <code>sources</code>, chuẩn hóa <code>mapping</code> &amp; Pipe Transform, kiểm định <code>schema</code>, tự làm mới token <code>authRefresh</code> khi gặp HTTP <code>401</code>, biến lỗi <code>{{_syncStatus}}</code> / <code>{{_syncError}}</code> / <code>{{_httpStatus}}</code> + <code>errorFallback</code> và Proxy gợi ý kiểu <code>Widget.createDataBinding&lt;T&gt;()</code>.
1495
+ </p>
1496
+ <div class="rounded-xl bg-amber-500/10 border border-amber-500/30 p-3.5 text-xs text-amber-200 leading-relaxed">
1497
+ <strong>⚠️ Lưu ý bắt buộc về Ngân sách Reload của OS:</strong> Không cam kết đồng bộ chính xác mỗi 15 phút khi app bị đóng. Apple WidgetKit sử dụng ngân sách reload động (thường khoảng <strong>40–70 lần/ngày</strong> tùy hành vi người dùng; <code>refreshIntervalMinutes</code> chỉ là mốc thời gian sớm nhất được đề xuất). Android cũng áp dụng giới hạn <em>Doze Mode</em> &amp; <em>App Standby Buckets</em> cho tác vụ nền.
1498
+ </div>
1499
+ <div class="relative">
1500
+ <button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
1501
+ <pre><code class="language-tsx">// 1. Structured Data Binding + Pipe Transform trực tiếp trong TSX
1502
+ const data = Widget.createDataBinding&lt;{
1503
+ user: { name: string };
1504
+ attendance: { progress: number };
1505
+ }&gt;({
1506
+ defaults: { user: { name: 'Nhân viên' }, attendance: { progress: 0 } },
1507
+ });
331
1508
 
332
- <!-- Card: JSX Syntax & In-App Widget Preview -->
333
- <div class="bg-cardBg border border-cardBorder rounded-xl p-4 space-y-3">
334
- <div class="flex items-center justify-between">
335
- <span class="text-sm font-semibold text-white">✨ Cú pháp JSX / TSX & Xem Trước Widget Trong App (&lt;WidgetPreview&gt;)</span>
336
- <span class="text-xs text-sky-400 bg-sky-500/10 px-2 py-0.5 rounded">v1.2.0 JSX</span>
337
- </div>
338
- <pre><code class="language-typescript">import { WidgetPreview, VStack, HStack, Text, Badge, Button } from 'react-native-live-widgets';
339
-
340
- // 1. Nhúng khung xem trước trực tiếp trên màn hình App (hỗ trợ small, medium, large)
341
- &lt;WidgetPreview size="medium" showBadge interactiveSizeSwitch onAction={(id) => alert(id)}&gt;
342
- &lt;VStack padding={16} backgroundColor="#0F172A" borderRadius={16}&gt;
343
- &lt;HStack justifyContent="spaceBetween"&gt;
344
- &lt;Text fontSize={14} fontWeight="bold" color="#FFFFFF"&gt;Ca làm sáng&lt;/Text&gt;
345
- &lt;Badge text="07:54 (Hợp lệ)" backgroundColor="#064E3B" textColor="#6EE7B7" /&gt;
346
- &lt;/HStack&gt;
347
- &lt;Button title="Làm mới dữ liệu" actionId="refresh" fullWidth /&gt;
348
- &lt;/VStack&gt;
349
- &lt;/WidgetPreview&gt;
350
-
351
- // 2. Cập nhật Widget ra Home Screen bằng JSX trực tiếp:
352
1509
  await Widget.setLayout('main', {
353
1510
  medium: (
354
- &lt;VStack padding={16} backgroundColor="#0F172A" borderRadius={16}&gt;
355
- &lt;Text fontSize={14} color="#FFF"&gt;Xin chào Trần Tuấn Vũ&lt;/Text&gt;
356
- &lt;Button title="Check-in" actionId="checkin" /&gt;
1511
+ &lt;VStack padding={14} spacing={6}&gt;
1512
+ &lt;Text&gt;{data.user.name}&lt;/Text&gt;
1513
+ &lt;Text&gt;{data.attendance.progress}%&lt;/Text&gt;
1514
+ &lt;Progress value={data.attendance.progress.divide(100)} /&gt;
357
1515
  &lt;/VStack&gt;
358
- )
1516
+ ),
1517
+ });
1518
+
1519
+ // 2. Cấu hình Background Data Engine 2.0 (TTL, ETag, Retry, Multi-source, Schema, Auth Refresh)
1520
+ await Widget.setRemoteConfig('main', {
1521
+ cacheTtlSeconds: 300,
1522
+ timeoutMs: 6000,
1523
+ enableETag: true,
1524
+ maxRetries: 2,
1525
+ retryDelayMs: 500,
1526
+ sources: {
1527
+ user: { url: 'https://api.yourcompany.com/v1/me' },
1528
+ attendance: { url: 'https://api.yourcompany.com/v1/attendance/today' },
1529
+ },
1530
+ schema: {
1531
+ requiredKeys: ['user.name', 'attendance.progress'],
1532
+ types: { 'attendance.progress': 'number' },
1533
+ },
1534
+ authRefresh: {
1535
+ url: 'https://api.yourcompany.com/v1/auth/refresh',
1536
+ method: 'POST',
1537
+ tokenPath: 'accessToken',
1538
+ },
1539
+ errorFallback: &lt;Text color="#F87171"&gt;Lỗi {{_httpStatus}}: {{_syncError}}&lt;/Text&gt;,
1540
+ refreshIntervalMinutes: 15, // Mốc gợi ý sớm nhất theo OS WidgetKit Budget
1541
+ }, 'group.com.yourcompany.app');</code></pre>
1542
+ </div>
1543
+ </div>
1544
+
1545
+ <!-- APNs & FCM Push Tokens -->
1546
+ <div id="api-push-token" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
1547
+ <div class="flex flex-wrap items-center justify-between gap-2">
1548
+ <h3 class="text-lg font-bold text-white">5. Quản lý 3 loại Push Token &amp; Payload Server (APNs / FCM)</h3>
1549
+ <span class="text-xs bg-rose-500/10 text-rose-300 border border-rose-500/20 px-2.5 py-1 rounded-full">Server Push</span>
1550
+ </div>
1551
+ <p class="text-xs sm:text-sm text-slate-300 leading-relaxed">
1552
+ Hỗ trợ lấy và theo dõi xoay token tự động cho cả 3 loại: <code>devicePushToken</code> (APNs/FCM thường), <code>pushToStartToken</code> (iOS 17.2+ bật mới Live Activity từ xa khi App đang tắt), và <code>activityUpdateToken</code> (đẩy bản cập nhật/kết thúc phiên đang chạy).
1553
+ </p>
1554
+ <div class="grid grid-cols-1 lg:grid-cols-2 gap-4">
1555
+ <div class="relative">
1556
+ <button onclick="copyCode(this)" class="absolute top-2 right-2 text-xs bg-slate-800 text-slate-300 px-2 py-0.5 rounded">Copy</button>
1557
+ <pre><code class="language-typescript">// Lấy toàn bộ token &amp; lắng nghe cập nhật từ Native
1558
+ const tokens = await LiveActivity.getAllPushTokens();
1559
+ console.log(tokens.devicePushToken, tokens.pushToStartToken);
1560
+
1561
+ LiveActivity.onPushToStartTokenChange((token) =&gt; {
1562
+ api.syncPushToStartToken(token);
1563
+ });
1564
+ LiveActivity.onActivityUpdateTokenChange(({ activityId, token }) =&gt; {
1565
+ api.syncActivityToken(activityId, token);
359
1566
  });</code></pre>
1567
+ </div>
1568
+ <div class="relative">
1569
+ <button onclick="copyCode(this)" class="absolute top-2 right-2 text-xs bg-slate-800 text-slate-300 px-2 py-0.5 rounded">Copy</button>
1570
+ <pre><code class="language-json">// Header APNs: apns-push-type: liveactivity | apns-topic: &lt;bundle_id&gt;.push-type.liveactivity
1571
+ {
1572
+ "aps": {
1573
+ "timestamp": 1711890000,
1574
+ "event": "update",
1575
+ "content-state": {
1576
+ "layoutJson": "{\"lockScreen\":{...},\"dynamicIsland\":{...}}"
1577
+ },
1578
+ "alert": { "title": "Đơn hàng đã giao!", "body": "Chúc bạn ngon miệng." }
1579
+ }
1580
+ }</code></pre>
1581
+ </div>
360
1582
  </div>
361
1583
  </div>
362
1584
  </section>
363
1585
 
364
- <!-- Section: AI Agent & LLM Hub -->
365
- <section id="llms-ai" class="space-y-6 pt-4 border-t border-cardBorder">
366
- <div class="flex items-center space-x-3">
367
- <div class="p-2 rounded-lg bg-indigo-500/10 border border-indigo-500/20 text-indigo-400">
368
- <i data-lucide="bot" class="w-6 h-6"></i>
1586
+ <!-- Section: Architecture, Semantics & Roadmap (v1.2.1) -->
1587
+ <section id="ir-semantic" class="space-y-6">
1588
+ <div class="border-b border-cardBorder pb-4">
1589
+ <div class="flex items-center space-x-2">
1590
+ <span class="px-2.5 py-0.5 rounded-full text-xs font-bold bg-indigo-500/20 text-indigo-300 border border-indigo-500/30 uppercase">Architecture v2.0</span>
1591
+ <h2 class="text-2xl sm:text-3xl font-extrabold text-white">
1592
+ 3 Trụ Cột Kiến Trúc &amp; UI Intermediate Representation (IR)
1593
+ </h2>
369
1594
  </div>
370
- <div>
371
- <h2 class="text-2xl sm:text-3xl font-bold text-white">AI Agent & LLM Hub (llms.txt)</h2>
372
- <p class="text-sm text-slate-400">Tối ưu 100% cho các mô hình AI: ChatGPT, Claude, Copilot, Cursor, Antigravity</p>
1595
+ <p class="mt-2 text-slate-400 text-sm sm:text-base leading-relaxed">
1596
+ Thay vì đi thẳng từ DSL &rarr; Bitmap thiếu ngữ nghĩa, thư viện áp dụng kiến trúc chuẩn công nghiệp với <strong>Semantic Tree độc lập khỏi Visual Renderer</strong>:
1597
+ </p>
1598
+ </div>
1599
+
1600
+ <div class="grid grid-cols-1 md:grid-cols-3 gap-4">
1601
+ <div class="bg-darkCard border border-cardBorder rounded-xl p-5 space-y-2">
1602
+ <h4 class="font-bold text-emerald-400 text-sm">✅ Điểm 1: Native Semantic Coverage</h4>
1603
+ <p class="text-xs text-slate-400 leading-relaxed">
1604
+ Phù hợp giới hạn whitelist của Android <code>RemoteViews</code>: mọi Text/Button/Toggle quan trọng đều có Semantics; thành phần đồ họa Canvas (Gauge, Chart, Equalizer) sinh kèm Accessibility Description thay thế.
1605
+ </p>
1606
+ </div>
1607
+ <div class="bg-darkCard border border-cardBorder rounded-xl p-5 space-y-2">
1608
+ <h4 class="font-bold text-sky-400 text-sm">✅ Điểm 2: Native-first, Canvas-when-needed</h4>
1609
+ <p class="text-xs text-slate-400 leading-relaxed">
1610
+ <code>Chronometer</code> và <code>FrameLayout</code> Hit Layer chạy hoàn toàn bằng Native RemoteViews; Canvas 2D chỉ vẽ các phần thực sự cần vẽ (đồ họa phức tạp, Gauge, Sparkline), giảm RAM và pin.
1611
+ </p>
1612
+ </div>
1613
+ <div class="bg-darkCard border border-cardBorder rounded-xl p-5 space-y-2">
1614
+ <h4 class="font-bold text-purple-400 text-sm">✅ Điểm 3: Semantic Tree độc lập Renderer (UI IR)</h4>
1615
+ <p class="text-xs text-slate-400 leading-relaxed">
1616
+ Cây <strong>UI IR</strong> tách làm 3 phần: Visual Tree, Semantic Tree và State Bindings — dùng API <code>Widget.inspectIR()</code> và <code>Widget.compileIR()</code> để kiểm toán trực tiếp kế hoạch render.
1617
+ </p>
373
1618
  </div>
374
1619
  </div>
375
1620
 
376
- <p class="text-slate-300">
377
- Thư viện tuân thủ chuẩn mở <strong><a href="https://llmstxt.org" target="_blank" class="text-sky-400 hover:underline">llms.txt</a></strong>,
378
- cho phép bất kỳ AI agent nào tự động đọc cấu trúc, API cheat sheet và các nguyên tắc kiến trúc để viết code widget chuẩn xác mà không bị ảo giác (hallucination).
1621
+ <div class="relative">
1622
+ <button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
1623
+ <pre><code class="language-typescript">import { Widget, UI } from 'react-native-live-widgets';
1624
+
1625
+ const layout = UI.VStack(
1626
+ { padding: 16, backgroundColor: '#0F172A' },
1627
+ UI.Text('BẢNG ĐIỀU KHIỂN CHẤM CÔNG', { typography: 'title2' }),
1628
+ UI.Progress({ value: 0.86, accessibilityLabel: 'Tiến độ hoàn thành ca' }),
1629
+ UI.Button({ title: 'Check In', actionId: 'toggle:attendance' }),
1630
+ UI.Gauge(0.92, { label: 'Hiệu suất' })
1631
+ );
1632
+
1633
+ // Phân tích chiến lược Native vs Canvas &amp; tóm tắt Trợ năng TalkBack/VoiceOver
1634
+ console.log(Widget.inspectIR(layout));
1635
+ const ir = Widget.compileIR(layout);
1636
+ console.log(ir.renderStrategy, ir.semanticSummary);</code></pre>
1637
+ </div>
1638
+
1639
+ <!-- Accessibility Layer -->
1640
+ <div id="a11y-layer" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
1641
+ <h3 class="font-bold text-white text-lg flex items-center space-x-2">
1642
+ <i data-lucide="accessibility" class="w-5 h-5 text-sky-400"></i>
1643
+ <span>Lớp Trợ năng Chuẩn hóa (VoiceOver iOS &amp; TalkBack Android)</span>
1644
+ </h3>
1645
+ <p class="text-xs sm:text-sm text-slate-300 leading-relaxed">
1646
+ Mọi node hỗ trợ đầy đủ <code>AccessibilityProps</code>: <code>accessible</code>, <code>accessibilityRole</code> (<code>'header' | 'button' | 'progressbar' | 'checkbox' | 'switch' | 'image' | 'summary'</code>), <code>accessibilityLabel</code>, <code>accessibilityHint</code>, và <code>accessibilityValue</code>. Trên Android, engine tự động duyệt đệ quy để gán tóm tắt vào <code>contentDescription</code> của Canvas và từng Hit Zone.
1647
+ </p>
1648
+ <div class="relative">
1649
+ <button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
1650
+ <pre><code class="language-tsx">&lt;VStack padding={16}&gt;
1651
+ &lt;Text typography="title2" accessibilityRole="header" accessibilityLabel="Bảng điều khiển chấm công"&gt;
1652
+ BẢNG ĐIỀU KHIỂN CHẤM CÔNG
1653
+ &lt;/Text&gt;
1654
+ &lt;Progress value={0.86} accessibilityLabel="Tiến độ hoàn thành ca" accessibilityValue="86 phần trăm" /&gt;
1655
+ &lt;Button
1656
+ title="Check-in vào ca"
1657
+ actionId="CHECK_IN"
1658
+ accessibilityRole="button"
1659
+ accessibilityHint="Chạm hai lần để gửi yêu cầu chấm công"
1660
+ /&gt;
1661
+ &lt;Image systemName="sparkles" accessible={false} /&gt;
1662
+ &lt;/VStack&gt;</code></pre>
1663
+ </div>
1664
+ </div>
1665
+
1666
+ <!-- Capability Matrix & Roadmap -->
1667
+ <div id="capability-matrix" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-5">
1668
+ <h3 class="font-bold text-white text-lg flex items-center space-x-2">
1669
+ <i data-lucide="table" class="w-5 h-5 text-emerald-400"></i>
1670
+ <span>Bảng Năng lực Nền tảng &amp; Lộ trình Phát triển 6 Phases (v1.2.1 Hoàn thiện 100%)</span>
1671
+ </h3>
1672
+
1673
+ <div class="overflow-x-auto">
1674
+ <table class="w-full text-left text-xs border-collapse">
1675
+ <thead>
1676
+ <tr class="border-b border-cardBorder text-slate-400">
1677
+ <th class="py-2 pr-3 font-semibold">Tính năng</th>
1678
+ <th class="py-2 pr-3 font-semibold">iOS WidgetKit / LA</th>
1679
+ <th class="py-2 pr-3 font-semibold">Android Home Widget</th>
1680
+ <th class="py-2 font-semibold">Graceful Fallback</th>
1681
+ </tr>
1682
+ </thead>
1683
+ <tbody class="divide-y divide-cardBorder text-slate-300">
1684
+ <tr>
1685
+ <td class="py-2 pr-3 font-semibold">Vùng bấm tương tác</td>
1686
+ <td class="py-2 pr-3">✅ iOS 17+ <code>AppIntent</code></td>
1687
+ <td class="py-2 pr-3">✅ Exact Hit Layer (<code>rn_hit_layer</code>)</td>
1688
+ <td class="py-2">Mở App xử lý queue qua PendingIntent</td>
1689
+ </tr>
1690
+ <tr>
1691
+ <td class="py-2 pr-3 font-semibold">Đồng hồ đếm ngược</td>
1692
+ <td class="py-2 pr-3">✅ SwiftUI Timer</td>
1693
+ <td class="py-2 pr-3">✅ Native <code>Chronometer</code></td>
1694
+ <td class="py-2">Cập nhật theo mốc thời gian hệ điều hành</td>
1695
+ </tr>
1696
+ <tr>
1697
+ <td class="py-2 pr-3 font-semibold">Gradient &amp; Dashed Border</td>
1698
+ <td class="py-2 pr-3">✅ SwiftUI</td>
1699
+ <td class="py-2 pr-3">✅ Shader &amp; <code>DashPathEffect</code></td>
1700
+ <td class="py-2">Hạ cấp về màu đầu tiên trong <code>colors</code> / nét liền</td>
1701
+ </tr>
1702
+ <tr>
1703
+ <td class="py-2 pr-3 font-semibold">Accessibility &amp; Dynamic Type</td>
1704
+ <td class="py-2 pr-3">✅ Native VoiceOver</td>
1705
+ <td class="py-2 pr-3">✅ A11y Summary + Hit-Zones + <code>fontScale</code></td>
1706
+ <td class="py-2">Tổng hợp ngữ nghĩa toàn cây cho bộ đọc màn hình</td>
1707
+ </tr>
1708
+ </tbody>
1709
+ </table>
1710
+ </div>
1711
+
1712
+ <div class="overflow-x-auto pt-2">
1713
+ <table class="w-full text-left text-xs border-collapse">
1714
+ <thead>
1715
+ <tr class="border-b border-cardBorder text-slate-400">
1716
+ <th class="py-2 pr-3 font-semibold">Phase</th>
1717
+ <th class="py-2 pr-3 font-semibold">Nội dung kiến trúc</th>
1718
+ <th class="py-2 font-semibold">Trạng thái v1.2.1</th>
1719
+ </tr>
1720
+ </thead>
1721
+ <tbody class="divide-y divide-cardBorder text-slate-300">
1722
+ <tr>
1723
+ <td class="py-2 pr-3 font-mono text-sky-400">Phase 1</td>
1724
+ <td class="py-2 pr-3">Accessibility Fallback Layer (<code>AccessibilityProps</code>, TalkBack &amp; VoiceOver)</td>
1725
+ <td class="py-2 text-emerald-400 font-semibold">✅ Hoàn thành</td>
1726
+ </tr>
1727
+ <tr>
1728
+ <td class="py-2 pr-3 font-mono text-sky-400">Phase 2</td>
1729
+ <td class="py-2 pr-3">UI Intermediate Representation (<code>src/ir.ts</code>, <code>Widget.inspectIR</code>)</td>
1730
+ <td class="py-2 text-emerald-400 font-semibold">✅ Hoàn thành</td>
1731
+ </tr>
1732
+ <tr>
1733
+ <td class="py-2 pr-3 font-mono text-sky-400">Phase 3 &amp; 4</td>
1734
+ <td class="py-2 pr-3">Native-first Hybrid (Chronometer, Exact Hit Layer) &amp; Two-way State Sync</td>
1735
+ <td class="py-2 text-emerald-400 font-semibold">✅ Hoàn thành</td>
1736
+ </tr>
1737
+ <tr>
1738
+ <td class="py-2 pr-3 font-mono text-sky-400">Phase 5 &amp; 6</td>
1739
+ <td class="py-2 pr-3">Canvas Sub-renderer (~40KB RAM) &amp; Automated Test Suite (<code>npm test</code>)</td>
1740
+ <td class="py-2 text-emerald-400 font-semibold">✅ Hoàn thành</td>
1741
+ </tr>
1742
+ </tbody>
1743
+ </table>
1744
+ </div>
1745
+ </div>
1746
+
1747
+ <!-- Extended Families & Complete Live Activity Lifecycle -->
1748
+ <div id="extended-families-lifecycle" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-5">
1749
+ <div class="flex flex-wrap items-center justify-between gap-2">
1750
+ <h3 class="font-bold text-white text-lg flex items-center space-x-2">
1751
+ <i data-lucide="smartphone" class="w-5 h-5 text-emerald-400"></i>
1752
+ <span>Widget Family Mở rộng (<code>extraLarge</code>, <code>standBy</code>, <code>ControlWidget</code>) &amp; Vòng đời Live Activity</span>
1753
+ </h3>
1754
+ <span class="text-xs bg-emerald-500/10 text-emerald-300 border border-emerald-500/20 px-2.5 py-1 rounded-full">OS Surfaces &amp; Lifecycle</span>
1755
+ </div>
1756
+ <p class="text-xs sm:text-sm text-slate-300 leading-relaxed">
1757
+ Hỗ trợ đầy đủ giao diện riêng cho <strong>iOS 17+ StandBy Mode</strong> (tự nhận diện <code>showsWidgetContainerBackground == false</code> kèm <code>.applyStandByMargins()</code> &amp; <code>widgetAccentable</code>), <strong>iPadOS / Tablet Extra Large</strong> (<code>extraLarge</code>), <strong>iOS 18+ Control Center / Action Button &amp; Android Quick Settings Tile</strong> (<code>ControlWidget</code> DSL, <code>DynamicControlWidget.swift</code>, <code>DynamicQuickSettingsTileService.kt</code>, <code>&lt;WidgetPreview size="control" /&gt;</code>), và hệ thống vòng đời Live Activity hoàn chỉnh (Stale, Relevance Score, AlertConfiguration, Scheduled End, Auto-Expiration, Push-to-Start &amp; Multi-Activity Inspection).
1758
+ </p>
1759
+ <div class="relative">
1760
+ <button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
1761
+ <pre><code class="language-typescript">// 1. Thiết lập StandBy + ExtraLarge + Control Widget (iOS 18+ / Android QS Tile)
1762
+ await Widget.setLayout('main', {
1763
+ small: compactNode,
1764
+ medium: mediumNode,
1765
+ large: largeNode,
1766
+ extraLarge: tabletDashboardNode,
1767
+ standBy: standByBigClockNode,
1768
+ });
1769
+
1770
+ const shiftCtrl = ControlWidget.toggle({
1771
+ title: 'Ca làm việc',
1772
+ subtitle: 'Chạm để chấm công',
1773
+ checkedTitle: 'Đang trong ca',
1774
+ checkedSubtitle: 'Nhấn để kết thúc',
1775
+ systemName: 'clock.badge.checkmark.fill',
1776
+ checked: true,
1777
+ actionId: 'toggle:attendance',
1778
+ });
1779
+ await ControlWidget.set('toggle', shiftCtrl);
1780
+ // Xem trước Control Tile ngay trong App: &lt;WidgetPreview size="control" controlConfig={shiftCtrl} /&gt;
1781
+
1782
+ // 2. Theo dõi toàn bộ vòng đời &amp; kiểm tra Live Activity đồng thời
1783
+ const unsubLifecycle = LiveActivity.onStateChange((event) =&gt; {
1784
+ console.log(`Activity ${event.activityId} -&gt; ${event.state}`);
1785
+ });
1786
+ const active = await LiveActivity.get('shift_01');
1787
+ const cleanedIds = await LiveActivity.cleanupExpired();</code></pre>
1788
+ </div>
1789
+ </div>
1790
+
1791
+ <!-- Troubleshooting -->
1792
+ <div id="troubleshooting" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
1793
+ <h3 class="font-bold text-white text-lg flex items-center space-x-2">
1794
+ <i data-lucide="wrench" class="w-5 h-5 text-amber-400"></i>
1795
+ <span>Xử lý Sự cố Thường gặp (Troubleshooting)</span>
1796
+ </h3>
1797
+ <ul class="space-y-3 text-xs sm:text-sm text-slate-300 leading-relaxed list-disc pl-5">
1798
+ <li>
1799
+ <strong>Widget hiện "Chọn 1 mẫu UI trong app để hiển thị":</strong> Kiểm tra App Group ID giữa Main App và Widget Extension đã trùng khớp chưa (vd <code>group.&lt;bundle_id&gt;</code>) và đảm bảo đã gọi <code>await Widget.setLayout('main', ...)</code>.
1800
+ </li>
1801
+ <li>
1802
+ <strong>Dynamic Island Compact bị tràn chiều ngang khi dùng <code>UI.Timer</code>:</strong> Đảm bảo đặt <code>fontSize</code> gọn (11–13) cho <code>compactTrailing</code>; thư viện đã tự tính độ rộng <code>compactWidth</code> tối ưu theo thời lượng còn lại.
1803
+ </li>
1804
+ <li>
1805
+ <strong>Ảnh từ URL mạng (<code>https://...</code>) không hiện trên Widget:</strong> Đảm bảo URL là HTTPS hợp lệ; thư viện tự tải ngầm, nén xuống 360px để không vượt giới hạn 30MB của WidgetKit và reload lại Widget khi tải xong.
1806
+ </li>
1807
+ <li>
1808
+ <strong>Lỗi build Swift 6 <code>type '()' cannot conform to 'View'</code> trên Xcode mới:</strong> Cập nhật lên phiên bản <strong><code>1.2.1</code></strong> trở lên (<code>npm install react-native-live-widgets@latest</code>).
1809
+ </li>
1810
+ </ul>
1811
+ </div>
1812
+ </section>
1813
+
1814
+ <!-- Section: AI Agent & LLM Hub (llms.txt) -->
1815
+ <section id="llms-ai" class="space-y-6">
1816
+ <div class="border-b border-cardBorder pb-4 flex items-center justify-between">
1817
+ <div class="flex items-center space-x-3">
1818
+ <div class="p-2.5 rounded-xl bg-indigo-500/10 border border-indigo-500/20 text-indigo-400">
1819
+ <i data-lucide="bot" class="w-6 h-6"></i>
1820
+ </div>
1821
+ <div>
1822
+ <h2 class="text-2xl sm:text-3xl font-extrabold text-white">AI Agent & LLMs Hub</h2>
1823
+ <p class="text-sm text-slate-400">Chuẩn hóa cho Claude Code, Antigravity, ChatGPT, Cursor Rules</p>
1824
+ </div>
1825
+ </div>
1826
+ <span class="text-xs bg-indigo-500/10 text-indigo-300 border border-indigo-500/30 px-3 py-1 rounded-full font-semibold">
1827
+ llms.txt Standard
1828
+ </span>
1829
+ </div>
1830
+
1831
+ <p class="text-slate-300 text-sm sm:text-base leading-relaxed">
1832
+ Tài liệu của thư viện tuân thủ 100% đặc tả <strong><a href="https://llmstxt.org" target="_blank" class="text-sky-400 hover:underline">llms.txt</a></strong>.
1833
+ Bất kỳ mô hình ngôn ngữ lớn hoặc coding agent nào cũng có thể đọc trực tiếp các file này qua URL để sinh mã widget chính xác, an toàn và không bị hallucination.
379
1834
  </p>
380
1835
 
381
- <div class="grid grid-cols-1 md:grid-cols-2 gap-4">
382
- <div class="bg-cardBg border border-indigo-900/40 rounded-xl p-5 space-y-3">
383
- <div class="flex items-center justify-between">
384
- <span class="font-bold text-white flex items-center space-x-2">
385
- <i data-lucide="file-text" class="w-4 h-4 text-indigo-400"></i>
386
- <span>Tập tin llms.txt</span>
1836
+ <div class="grid grid-cols-1 md:grid-cols-2 gap-6">
1837
+
1838
+ <!-- llms.txt card -->
1839
+ <div class="bg-darkCard border border-indigo-900/40 rounded-2xl p-6 space-y-4">
1840
+ <div class="flex items-center justify-between gap-2 flex-wrap">
1841
+ <span class="font-bold text-white text-base flex items-center space-x-2">
1842
+ <i data-lucide="file-text" class="w-5 h-5 text-indigo-400"></i>
1843
+ <span>Tập tin llms.txt &amp; llms-full.txt</span>
387
1844
  </span>
388
- <a href="llms.txt" target="_blank" class="text-xs bg-indigo-500/10 text-indigo-300 border border-indigo-500/30 px-2 py-0.5 rounded hover:bg-indigo-500/20">
389
- Xem file raw ↗
390
- </a>
1845
+ <div class="flex items-center space-x-2">
1846
+ <a href="llms.txt" target="_blank" class="text-xs text-indigo-300 bg-indigo-500/10 border border-indigo-500/20 px-2.5 py-1 rounded-md hover:bg-indigo-500/20">
1847
+ llms.txt ↗
1848
+ </a>
1849
+ <a href="llms-full.txt" target="_blank" class="text-xs text-sky-300 bg-sky-500/10 border border-sky-500/20 px-2.5 py-1 rounded-md hover:bg-sky-500/20">
1850
+ llms-full.txt ↗
1851
+ </a>
1852
+ </div>
391
1853
  </div>
392
- <p class="text-xs text-slate-400">
393
- Chứa tóm tắt kiến trúc, bảng hàm DSL và 5 quy tắc vàng giúp AI sinh mã TypeScript widget an toàn.
1854
+ <p class="text-xs text-slate-400 leading-relaxed">
1855
+ Tóm tắt xúc tích về toàn bộ API, UI IR, cấu trúc JSON AST và quy tắc vàng giúp AI lập trình widget chính xác trên v1.2.1.
394
1856
  </p>
395
- <pre><code class="language-bash">curl -s https://react-native-vu.github.io/react-native-live-widgets/llms.txt</code></pre>
1857
+ <div class="relative">
1858
+ <button onclick="copyCode(this)" class="absolute top-2 right-2 text-xs bg-slate-800 text-slate-300 px-2 py-0.5 rounded">Copy</button>
1859
+ <pre><code class="language-bash"># Nạp trực tiếp vào Prompt của Agent
1860
+ curl -s https://react-native-vu.github.io/react-native-live-widgets/llms.txt
1861
+ curl -s https://react-native-vu.github.io/react-native-live-widgets/llms-full.txt</code></pre>
1862
+ </div>
396
1863
  </div>
397
1864
 
398
- <div id="agent-skill" class="bg-cardBg border border-indigo-900/40 rounded-xl p-5 space-y-3">
1865
+ <!-- SKILL.md card -->
1866
+ <div id="agent-skill" class="bg-darkCard border border-indigo-900/40 rounded-2xl p-6 space-y-4">
399
1867
  <div class="flex items-center justify-between">
400
- <span class="font-bold text-white flex items-center space-x-2">
401
- <i data-lucide="cpu" class="w-4 h-4 text-sky-400"></i>
1868
+ <span class="font-bold text-white text-base flex items-center space-x-2">
1869
+ <i data-lucide="cpu" class="w-5 h-5 text-sky-400"></i>
402
1870
  <span>Agent Skill (SKILL.md)</span>
403
1871
  </span>
404
- <a href="https://github.com/React-Native-Vu/react-native-live-widgets/blob/dev/skills/react-native-live-widgets/SKILL.md" target="_blank" class="text-xs bg-sky-500/10 text-sky-300 border border-sky-500/30 px-2 py-0.5 rounded hover:bg-sky-500/20">
405
- Xem SKILL.md ↗
1872
+ <a href="https://github.com/React-Native-Vu/react-native-live-widgets/blob/dev/skills/react-native-live-widgets/SKILL.md" target="_blank" class="text-xs text-sky-300 bg-sky-500/10 border border-sky-500/20 px-2.5 py-1 rounded-md hover:bg-sky-500/20">
1873
+ GitHub SKILL.md ↗
406
1874
  </a>
407
1875
  </div>
408
- <p class="text-xs text-slate-400">
409
- Tương thích trực tiếp với các hệ thống coding agent như Antigravity, Claude Code, Cursor Rules để kích hoạt tự động theo ngữ cảnh.
1876
+ <p class="text-xs text-slate-400 leading-relaxed">
1877
+ Tương thích trực tiếp với các framework Agent như Antigravity, Claude Code, Cursor Rules để kích hoạt theo ngữ cảnh của lập trình viên.
410
1878
  </p>
411
- <pre><code class="language-bash"># Vị trí skill trong dự án của bạn
1879
+ <div class="relative">
1880
+ <button onclick="copyCode(this)" class="absolute top-2 right-2 text-xs bg-slate-800 text-slate-300 px-2 py-0.5 rounded">Copy</button>
1881
+ <pre><code class="language-bash"># Lưu vào thư mục agent trong repo của bạn:
412
1882
  .agents/skills/react-native-live-widgets/SKILL.md</code></pre>
1883
+ </div>
413
1884
  </div>
1885
+
414
1886
  </div>
415
1887
  </section>
416
1888
 
@@ -418,23 +1890,549 @@ await Widget.setLayout('main', {
418
1890
  </div>
419
1891
 
420
1892
  <!-- Footer -->
421
- <footer class="border-t border-cardBorder bg-cardBg/50 py-8 mt-16">
422
- <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 flex flex-col sm:flex-row items-center justify-between text-xs text-slate-400 gap-4">
423
- <div>
424
- Phát triển bởi <strong class="text-white">vu-tran</strong> • Giấy phép MIT •
425
- <a href="https://github.com/React-Native-Vu/react-native-live-widgets" class="text-sky-400 hover:underline">GitHub Repository</a>
1893
+ <footer class="border-t border-cardBorder bg-slate-950/80 py-12 mt-16">
1894
+ <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 flex flex-col md:flex-row items-center justify-between gap-6 text-xs text-slate-400">
1895
+
1896
+ <div class="flex items-center space-x-3">
1897
+ <div class="w-8 h-8 rounded-lg bg-sky-600/20 text-sky-400 flex items-center justify-center font-bold">
1898
+ ⚡
1899
+ </div>
1900
+ <div>
1901
+ <p class="text-slate-300 font-medium" data-i18n="footer_dev">react-native-live-widgets — Phát triển bởi <strong>Trần Tuấn Vũ</strong></p>
1902
+ <p class="text-[11px] text-slate-500" data-i18n="footer_sub">Giấy phép mã nguồn mở MIT • Sẵn sàng cho Production</p>
1903
+ </div>
426
1904
  </div>
427
- <div class="flex items-center space-x-4">
428
- <a href="llms.txt" class="hover:text-white transition">llms.txt</a>
429
- <a href="llms-full.txt" class="hover:text-white transition">llms-full.txt</a>
430
- <a href="EXPO-GUIDE-VI.md" class="hover:text-white transition">Expo Guide</a>
1905
+
1906
+ <div class="flex flex-wrap items-center gap-6">
1907
+ <a href="https://react-native-vu.github.io/react-native-live-widgets/" target="_blank" class="hover:text-white transition text-sky-400 font-medium">Web Docs</a>
1908
+ <a href="https://github.com/React-Native-Vu/react-native-live-widgets" target="_blank" class="hover:text-white transition flex items-center space-x-1">
1909
+ <i data-lucide="github" class="w-4 h-4"></i>
1910
+ <span>GitHub</span>
1911
+ </a>
1912
+ <a href="https://www.npmjs.com/package/react-native-live-widgets" target="_blank" class="hover:text-white transition">npm package</a>
1913
+ <a href="llms.txt" class="hover:text-white transition font-mono text-sky-400">llms.txt</a>
1914
+ <a href="llms-full.txt" class="hover:text-white transition font-mono">llms-full.txt</a>
1915
+ <a href="GUIDE-VI.md" class="hover:text-white transition">Tài liệu tiếng Việt</a>
1916
+ <a href="GUIDE-EN.md" class="hover:text-white transition">English Guide</a>
431
1917
  </div>
1918
+
432
1919
  </div>
433
1920
  </footer>
434
1921
 
1922
+ <!-- Floating Back to Top Button -->
1923
+ <button id="back-to-top" onclick="window.scrollTo({top: 0, behavior: 'smooth'})" class="fixed bottom-6 right-6 p-3 rounded-full bg-slate-800/90 text-slate-300 hover:text-white border border-slate-700 shadow-xl opacity-0 pointer-events-none transition-all duration-300 z-50">
1924
+ <i data-lucide="arrow-up" class="w-5 h-5"></i>
1925
+ </button>
1926
+
1927
+ <!-- Interactive Simulator & Utility Scripts -->
435
1928
  <script>
436
- // Initialize Lucide icons
437
- lucide.createIcons();
1929
+ // State of Simulator
1930
+ let currentSimState = 'delivery';
1931
+ let counterValue = 42;
1932
+ let timerSeconds = 1495; // 24:55
1933
+ let timerInterval = null;
1934
+
1935
+ // Simulator Data Definitions
1936
+ const simulatorPresets = {
1937
+ delivery: {
1938
+ codeLabel: 'TypeScript — LiveActivity.start() & Dynamic Island',
1939
+ render: () => `
1940
+ <div class="flex flex-col space-y-3">
1941
+ <div class="flex items-center justify-between text-xs text-slate-400">
1942
+ <span class="flex items-center space-x-1 text-sky-400 font-semibold">
1943
+ <i data-lucide="bike" class="w-4 h-4"></i>
1944
+ <span>Fastdo Express</span>
1945
+ </span>
1946
+ <span class="bg-sky-500/20 text-sky-300 px-2 py-0.5 rounded-full text-[10px] font-bold">12 phút nữa</span>
1947
+ </div>
1948
+
1949
+ <div class="flex items-center justify-between">
1950
+ <div>
1951
+ <p class="font-bold text-base text-white">Tài xế đang giao cà phê</p>
1952
+ <p class="text-xs text-slate-400">Nguyễn Văn A • Winner X (43-D1 888.88)</p>
1953
+ </div>
1954
+ <span class="text-2xl">☕</span>
1955
+ </div>
1956
+
1957
+ <!-- Progress Bar -->
1958
+ <div class="w-full bg-slate-800 rounded-full h-2.5 overflow-hidden">
1959
+ <div class="bg-gradient-to-r from-sky-400 to-teal-400 h-2.5 rounded-full" style="width: 75%"></div>
1960
+ </div>
1961
+
1962
+ <div class="flex justify-between text-[11px] text-slate-400">
1963
+ <span>Đã nhận đơn</span>
1964
+ <span>Đang pha chế</span>
1965
+ <span class="text-sky-300 font-bold">Đang giao</span>
1966
+ <span>Đến nơi</span>
1967
+ </div>
1968
+ </div>
1969
+ `,
1970
+ code: `await LiveActivity.start({
1971
+ activityName: 'DeliveryTracking',
1972
+ appGroup: 'group.com.fastdo.app',
1973
+ layout: UI.VStack({
1974
+ padding: 16,
1975
+ backgroundColor: '#0F172A',
1976
+ children: [
1977
+ UI.HStack({
1978
+ justifyContent: 'spaceBetween',
1979
+ children: [
1980
+ UI.Text('Fastdo Express', { color: '#38BDF8', fontWeight: 'bold' }),
1981
+ UI.Text('12 phút nữa', { color: '#FFFFFF' })
1982
+ ]
1983
+ }),
1984
+ UI.Text('Tài xế đang giao cà phê', { fontSize: 16, fontWeight: 'bold' }),
1985
+ UI.Progress({ style: 'bar', value: 0.75, tintColor: '#38BDF8' })
1986
+ ]
1987
+ }),
1988
+ dynamicIsland: {
1989
+ compactLeading: UI.Text('☕', { fontSize: 13 }),
1990
+ compactTrailing: UI.Text('12m', { color: '#38BDF8', fontWeight: 'bold' }),
1991
+ expanded: {
1992
+ leading: UI.Text('COFFEE EXPRESS', { fontSize: 11 }),
1993
+ trailing: UI.Text('12 mins', { fontSize: 15, fontWeight: 'bold' })
1994
+ }
1995
+ }
1996
+ });`
1997
+ },
1998
+
1999
+ music: {
2000
+ codeLabel: 'TypeScript — UI.Equalizer & Dynamic Island Expanded',
2001
+ render: () => `
2002
+ <div class="flex flex-col space-y-3">
2003
+ <div class="flex items-center justify-between text-xs text-purple-400 font-semibold">
2004
+ <span class="flex items-center space-x-1">
2005
+ <i data-lucide="radio" class="w-4 h-4"></i>
2006
+ <span>Apple Music / Spotify Live</span>
2007
+ </span>
2008
+ <span class="text-[10px] text-purple-300 bg-purple-900/40 px-2 py-0.5 rounded-full">Lossless 24-bit</span>
2009
+ </div>
2010
+
2011
+ <div class="flex items-center space-x-4">
2012
+ <!-- Album cover -->
2013
+ <div class="w-12 h-12 rounded-xl bg-gradient-to-tr from-purple-600 to-pink-500 flex items-center justify-center text-white shadow-lg">
2014
+ <i data-lucide="disc" class="w-6 h-6 animate-spin" style="animation-duration: 8s;"></i>
2015
+ </div>
2016
+ <div class="flex-1 min-w-0">
2017
+ <p class="font-bold text-sm text-white truncate">Chạy Ngay Đi (Acoustic Version)</p>
2018
+ <p class="text-xs text-slate-400 truncate">Sơn Tùng M-TP</p>
2019
+ </div>
2020
+ <!-- Animated Equalizer Waves -->
2021
+ <div class="flex items-end space-x-1 h-7 px-2">
2022
+ <div class="w-1 bg-purple-400 rounded-full eq-bar-1"></div>
2023
+ <div class="w-1 bg-purple-400 rounded-full eq-bar-2"></div>
2024
+ <div class="w-1 bg-purple-300 rounded-full eq-bar-3"></div>
2025
+ <div class="w-1 bg-purple-400 rounded-full eq-bar-4"></div>
2026
+ <div class="w-1 bg-pink-400 rounded-full eq-bar-5"></div>
2027
+ </div>
2028
+ </div>
2029
+
2030
+ <div class="flex items-center justify-between pt-1">
2031
+ <span class="text-[10px] text-slate-400 font-mono">01:45</span>
2032
+ <div class="flex-1 mx-3 bg-slate-800 rounded-full h-1.5 overflow-hidden">
2033
+ <div class="bg-purple-500 h-1.5 rounded-full" style="width: 45%"></div>
2034
+ </div>
2035
+ <span class="text-[10px] text-slate-400 font-mono">03:52</span>
2036
+ </div>
2037
+ </div>
2038
+ `,
2039
+ code: `// Dynamic Island phát nhạc với sóng âm Equalizer tự động
2040
+ await LiveActivity.start({
2041
+ activityName: 'MusicPlayer',
2042
+ appGroup: 'group.com.myapp',
2043
+ dynamicIsland: {
2044
+ compactLeading: UI.Text('🎵', { fontSize: 13 }),
2045
+ compactTrailing: UI.Equalizer({
2046
+ barCount: 4,
2047
+ color: '#A855F7',
2048
+ height: 14
2049
+ }),
2050
+ expanded: {
2051
+ leading: UI.Text('Chạy Ngay Đi', { fontWeight: 'bold' }),
2052
+ trailing: UI.Equalizer({
2053
+ barCount: 5,
2054
+ color: '#A855F7',
2055
+ height: 22
2056
+ })
2057
+ }
2058
+ }
2059
+ });`
2060
+ },
2061
+
2062
+ pomodoro: {
2063
+ codeLabel: 'TypeScript — UI.Timer (Phần Cứng Không Tốn Pin)',
2064
+ render: () => {
2065
+ const m = String(Math.floor(timerSeconds / 60)).padStart(2, '0');
2066
+ const s = String(timerSeconds % 60).padStart(2, '0');
2067
+ return `
2068
+ <div class="flex flex-col items-center py-2 space-y-3">
2069
+ <div class="flex items-center space-x-2 text-xs text-amber-400 font-semibold">
2070
+ <i data-lucide="flame" class="w-4 h-4"></i>
2071
+ <span>POMODORO FOCUS SESSION</span>
2072
+ </div>
2073
+ <div class="text-4xl font-extrabold text-white font-mono tracking-wider text-sky-400" id="live-timer-display">
2074
+ ${m}:${s}
2075
+ </div>
2076
+ <p class="text-xs text-slate-400">Bộ đếm phần cứng iOS/Android Native Timer</p>
2077
+ <div class="flex space-x-2 mt-2">
2078
+ <button onclick="resetTimer()" class="px-3 py-1 bg-slate-800 hover:bg-slate-700 text-xs rounded-lg text-slate-300">Reset 25m</button>
2079
+ </div>
2080
+ </div>
2081
+ `;
2082
+ },
2083
+ code: `// Tự động đếm lùi 25 phút mượt mà mà KHÔNG hao tổn 1% pin nào!
2084
+ UI.Timer({
2085
+ targetTimestamp: Date.now() + 25 * 60 * 1000,
2086
+ isCountDown: true,
2087
+ color: '#38BDF8',
2088
+ fontSize: 32,
2089
+ fontWeight: 'heavy'
2090
+ })`
2091
+ },
2092
+
2093
+ 'widget-interactive': {
2094
+ codeLabel: 'TypeScript / JSX — Home Screen Widget Tương Tác 2 Chiều',
2095
+ render: () => `
2096
+ <div class="flex flex-col space-y-3 bg-slate-900/90 p-2 rounded-2xl">
2097
+ <div class="flex items-center justify-between text-xs">
2098
+ <span class="text-slate-400 font-bold uppercase tracking-wider">Tiện ích Điểm Danh</span>
2099
+ <span class="text-[10px] bg-emerald-500/20 text-emerald-400 px-2 py-0.5 rounded-full font-bold">AppIntents Ready</span>
2100
+ </div>
2101
+
2102
+ <div class="flex items-center justify-between py-1">
2103
+ <div>
2104
+ <p class="text-xs text-slate-400">Số lượt ghi nhận hôm nay</p>
2105
+ <p class="text-3xl font-extrabold text-sky-400 font-mono" id="sim-counter-text">${counterValue}</p>
2106
+ </div>
2107
+ <div class="text-right">
2108
+ <span class="text-xs text-slate-400">Trạng thái</span>
2109
+ <p class="text-xs font-bold text-emerald-400">Đã đồng bộ</p>
2110
+ </div>
2111
+ </div>
2112
+
2113
+ <!-- Interactive Buttons inside the widget -->
2114
+ <div class="grid grid-cols-2 gap-2 pt-1">
2115
+ <button onclick="handleSimCounter(1)" class="w-full py-2 px-3 rounded-xl bg-sky-600 hover:bg-sky-500 text-white font-bold text-xs transition active:scale-95 shadow">
2116
+ +1 Điểm danh
2117
+ </button>
2118
+ <button onclick="handleSimCounter(5)" class="w-full py-2 px-3 rounded-xl bg-slate-800 hover:bg-slate-700 text-slate-200 font-semibold text-xs transition active:scale-95 border border-slate-700">
2119
+ +5 Ghi nhận
2120
+ </button>
2121
+ </div>
2122
+ </div>
2123
+ `,
2124
+ code: `// 1. Cập nhật giao diện Widget với nút bấm tương tác
2125
+ Widget.reload('attendance', {
2126
+ layout: UI.VStack({
2127
+ padding: 14,
2128
+ backgroundColor: '#0F172A',
2129
+ children: [
2130
+ UI.Text('BỘ ĐẾM ĐIỂM DANH', { color: '#94A3B8', fontSize: 11 }),
2131
+ UI.Text(\`\${counter}\`, { color: '#38BDF8', fontSize: 32, fontWeight: 'heavy' }),
2132
+ UI.Button({
2133
+ title: '+1 Điểm danh',
2134
+ actionId: 'INCREMENT',
2135
+ backgroundColor: '#0284C7'
2136
+ })
2137
+ ]
2138
+ })
2139
+ });
2140
+
2141
+ // 2. Lắng nghe hành động trực tiếp trong React Native (không gián đoạn)
2142
+ useWidgetAction('INCREMENT', () => {
2143
+ setCounter(c => c + 1);
2144
+ });`
2145
+ }
2146
+ };
2147
+
2148
+ function switchSimulator(mode) {
2149
+ currentSimState = mode;
2150
+
2151
+ // Update buttons style
2152
+ document.querySelectorAll('.sim-btn').forEach(btn => {
2153
+ btn.classList.remove('bg-sky-600', 'text-white', 'shadow-lg', 'shadow-sky-600/30');
2154
+ btn.classList.add('bg-slate-800', 'text-slate-300', 'hover:bg-slate-700', 'border', 'border-slate-700');
2155
+ });
2156
+ const activeBtn = document.getElementById('btn-sim-' + mode);
2157
+ if (activeBtn) {
2158
+ activeBtn.classList.remove('bg-slate-800', 'text-slate-300', 'hover:bg-slate-700');
2159
+ activeBtn.classList.add('bg-sky-600', 'text-white', 'shadow-lg', 'shadow-sky-600/30');
2160
+ }
2161
+
2162
+ // Render preset
2163
+ const preset = simulatorPresets[mode];
2164
+ document.getElementById('sim-island-box').innerHTML = preset.render();
2165
+ document.getElementById('sim-code-label').innerText = preset.codeLabel;
2166
+
2167
+ const codeEl = document.getElementById('sim-code');
2168
+ codeEl.textContent = preset.code;
2169
+ Prism.highlightElement(codeEl);
2170
+ lucide.createIcons();
2171
+
2172
+ // Manage Pomodoro timer interval
2173
+ if (mode === 'pomodoro') {
2174
+ startTimerInterval();
2175
+ } else {
2176
+ clearInterval(timerInterval);
2177
+ }
2178
+ }
2179
+
2180
+ function handleSimCounter(delta) {
2181
+ counterValue += delta;
2182
+ const el = document.getElementById('sim-counter-text');
2183
+ if (el) {
2184
+ el.innerText = counterValue;
2185
+ el.classList.add('scale-110');
2186
+ setTimeout(() => el.classList.remove('scale-110'), 150);
2187
+ }
2188
+ }
2189
+
2190
+ function startTimerInterval() {
2191
+ clearInterval(timerInterval);
2192
+ timerInterval = setInterval(() => {
2193
+ if (timerSeconds > 0) {
2194
+ timerSeconds--;
2195
+ const el = document.getElementById('live-timer-display');
2196
+ if (el) {
2197
+ const m = String(Math.floor(timerSeconds / 60)).padStart(2, '0');
2198
+ const s = String(timerSeconds % 60).padStart(2, '0');
2199
+ el.innerText = `${m}:${s}`;
2200
+ }
2201
+ }
2202
+ }, 1000);
2203
+ }
2204
+
2205
+ function resetTimer() {
2206
+ timerSeconds = 1500;
2207
+ startTimerInterval();
2208
+ }
2209
+
2210
+ function copySimulatorCode() {
2211
+ const code = document.getElementById('sim-code').textContent;
2212
+ navigator.clipboard.writeText(code).then(() => {
2213
+ alert('Đã sao chép mã ví dụ vào Clipboard!');
2214
+ });
2215
+ }
2216
+
2217
+ function copyCode(btn) {
2218
+ const pre = btn.parentElement.querySelector('pre code');
2219
+ if (!pre) return;
2220
+ navigator.clipboard.writeText(pre.textContent).then(() => {
2221
+ const originalText = btn.innerText;
2222
+ btn.innerText = 'Đã chép!';
2223
+ btn.classList.add('text-emerald-400');
2224
+ setTimeout(() => {
2225
+ btn.innerText = originalText;
2226
+ btn.classList.remove('text-emerald-400');
2227
+ }, 1800);
2228
+ });
2229
+ }
2230
+
2231
+ function copyText(text, btn) {
2232
+ navigator.clipboard.writeText(text).then(() => {
2233
+ const span = btn.querySelector('span');
2234
+ if (span) {
2235
+ const old = span.innerText;
2236
+ span.innerText = 'Đã chép!';
2237
+ setTimeout(() => { span.innerText = old; }, 1500);
2238
+ }
2239
+ });
2240
+ }
2241
+
2242
+ // Multilingual i18n Dictionary (Vietnamese & English)
2243
+ const translations = {
2244
+ vi: {
2245
+ announcement_tag: 'Mới v1.2.1',
2246
+ announcement_text: 'Exact Dynamic Hit Layer, Native Chronometer Countdown, Swift 6 Ready & Chuẩn hoá <strong>UI IR</strong>',
2247
+ announcement_link: 'Xem chi tiết &rarr;',
2248
+ brand_subtitle: 'Declarative Widgets & Dynamic Island Engine',
2249
+ nav_sim: 'Live Simulator',
2250
+ nav_install: 'Cài đặt',
2251
+ nav_dsl: 'UI DSL & JSX',
2252
+ nav_api: 'API Reference',
2253
+ hero_badge: '100% Declarative UI • Không viết Swift / Kotlin • Expo CNG Ready',
2254
+ hero_title_1: 'Live Activities & Dynamic Island',
2255
+ hero_title_2: 'Chỉ với TypeScript & JSX',
2256
+ hero_desc: 'Giải pháp toàn diện All-in-One cho <strong>Live Activities</strong>, <strong>Dynamic Island</strong> và <strong>Interactive Home Screen Widgets</strong> trên cả iOS & Android. Tích hợp sẵn bộ mô phỏng <code>&lt;WidgetPreview&gt;</code> và chuẩn dữ liệu mở cho AI Agent.',
2257
+ hero_btn_install: 'Bắt đầu Cài đặt',
2258
+ hero_btn_sim: 'Trải nghiệm Live Simulator',
2259
+ hero_btn_expo: 'Expo Sample App ↗',
2260
+ btn_copy: 'Copy',
2261
+ btn_copy_code: 'Copy Code',
2262
+ sim_header_badge: 'Tương tác trực tiếp trên trình duyệt',
2263
+ sim_header_title: 'Live Simulator: Trải Nghiệm Widget & Dynamic Island',
2264
+ sim_header_desc: 'Nhấp chuột vào các chế độ bên dưới để xem Dynamic Island co dãn, sóng âm Equalizer chuyển động và nút bấm Home Widget phản hồi tức thì!',
2265
+ sim_tab_delivery: '1. Giao đồ ăn (Dynamic Island)',
2266
+ sim_tab_music: '2. Sóng nhạc Equalizer',
2267
+ sim_tab_pomodoro: '3. Bấm giờ Phần cứng (UI.Timer)',
2268
+ sim_tab_widget: '4. Home Widget Tương Tác 2 Chiều',
2269
+ sim_hint: 'Nhấn vào các nút bên trong widget để thấy phản hồi tương tác!',
2270
+ sim_code_label: 'Mã TypeScript Declarative',
2271
+ why_title: 'Tại sao chọn `react-native-live-widgets`?',
2272
+ why_desc: 'Kiến trúc đột phá giúp phát triển Widget Native nhanh gấp 10 lần mà vẫn bảo toàn hiệu năng tối đa.',
2273
+ f1_title: '100% Không Viết Swift / Kotlin',
2274
+ f1_desc: 'Viết giao diện hoàn toàn bằng JavaScript/TypeScript hoặc cú pháp JSX. Thư viện tự động chuyển đổi thành cây Native AST cho WidgetKit và RemoteViews.',
2275
+ f2_title: 'Tương Tác 2 Chiều (AppIntents)',
2276
+ f2_desc: 'Nút bấm trên Home Widget kích hoạt trực tiếp hàm JavaScript trong React Native qua React Hook useWidgetAction() mà không cần mở toàn màn hình ứng dụng.',
2277
+ f3_title: 'Timer Phần Cứng (0% Tiêu Hao Pin)',
2278
+ f3_desc: 'UI.Timer tự động đếm giây mượt mà trên Dynamic Island dựa vào chip hệ thống của iOS/Android mà không làm thức giấc CPU hay hao tổn pin thiết bị.',
2279
+ f4_title: 'Sóng Nhạc Động (Equalizer)',
2280
+ f4_desc: 'Duy nhất trên thị trường hỗ trợ hiệu ứng sóng âm thanh chuyển động liên tục cho ứng dụng nghe nhạc, podcast, radio trực tiếp trên Dynamic Island & Notification.',
2281
+ f5_title: 'Đồng Bộ Ngầm Khi Kill App',
2282
+ f5_desc: 'Hàm Widget.setRemoteConfig() cho phép cấu hình URL API ngầm để hệ điều hành iOS/Android tự động fetch dữ liệu mới cho Widget kể cả khi ứng dụng đã bị tắt.',
2283
+ f6_title: 'Chuẩn AI Agent (llms.txt)',
2284
+ f6_desc: 'Sẵn sàng 100% cho ChatGPT, Claude Code, Cursor, Antigravity thông qua llms.txt và SKILL.md. Agent của bạn có thể tự lập trình widget không lỗi.',
2285
+ dsl_image_title: 'Hình ảnh & Biểu tượng Hệ thống: <code>UI.Image</code> & <code>&lt;Image&gt;</code>',
2286
+ dsl_image_desc: 'Hỗ trợ <strong>5 nguồn ảnh</strong>: <code>url</code> (tự tải ngầm, nén tối đa 360px tránh vượt ngưỡng 30MB WidgetKit và lưu vào App Group cache), <code>base64</code> (QR/Barcode), <code>systemName</code>, <code>assetName</code>, và <code>filePath</code>. Đặc biệt hỗ trợ icon hệ thống đa nền tảng chuyên biệt: <code>systemNameIos</code> (Apple SF Symbols) và <code>systemNameAndroid</code> (Google Material Icons) với gợi ý type IntelliSense đầy đủ.',
2287
+ side_quick_start: 'Cài đặt All-in-One CLI',
2288
+ side_expo_setup: 'Expo (Config Plugin & CNG)',
2289
+ side_bare_rn: 'Bare React Native CLI',
2290
+ side_jsx_support: 'Cú pháp JSX / TSX & StyleSheet',
2291
+ side_widget_preview: 'Mô phỏng &lt;WidgetPreview&gt;',
2292
+ side_exact_hit: 'Exact Hit Layer & Chronometer (v1.2.1)',
2293
+ side_dsl_image: 'UI.Image & System Icons (Apple / Google)',
2294
+ footer_dev: 'react-native-live-widgets — Phát triển bởi <strong>Trần Tuấn Vũ</strong>',
2295
+ footer_sub: 'Giấy phép mã nguồn mở MIT • Sẵn sàng cho Production',
2296
+ },
2297
+ en: {
2298
+ announcement_tag: 'New v1.2.1',
2299
+ announcement_text: 'Exact Dynamic Hit Layer, Native Chronometer Countdown, Swift 6 Ready & Standardized <strong>UI IR</strong>',
2300
+ announcement_link: 'Learn more &rarr;',
2301
+ brand_subtitle: 'Declarative Widgets & Dynamic Island Engine',
2302
+ nav_sim: 'Live Simulator',
2303
+ nav_install: 'Installation',
2304
+ nav_dsl: 'UI DSL & JSX',
2305
+ nav_api: 'API Reference',
2306
+ hero_badge: '100% Declarative UI • Zero Swift / Kotlin • Expo CNG Ready',
2307
+ hero_title_1: 'Live Activities & Dynamic Island',
2308
+ hero_title_2: 'Powered by TypeScript & JSX',
2309
+ hero_desc: 'All-in-One declarative solution for <strong>Live Activities</strong>, <strong>Dynamic Island</strong>, and <strong>Interactive Home Screen Widgets</strong> on iOS & Android. Built-in <code>&lt;WidgetPreview&gt;</code> and open AI Agent standard.',
2310
+ hero_btn_install: 'Get Started',
2311
+ hero_btn_sim: 'Live Simulator',
2312
+ hero_btn_expo: 'Expo Sample App ↗',
2313
+ btn_copy: 'Copy',
2314
+ btn_copy_code: 'Copy Code',
2315
+ sim_header_badge: 'Interactive In-Browser Demo',
2316
+ sim_header_title: 'Live Simulator: Dynamic Island & Home Widgets',
2317
+ sim_header_desc: 'Click presets below to see Dynamic Island morphing, live Equalizer waves, and instant Home Widget button reactions!',
2318
+ sim_tab_delivery: '1. Food Delivery (Dynamic Island)',
2319
+ sim_tab_music: '2. Live Equalizer Waves',
2320
+ sim_tab_pomodoro: '3. Hardware Timer (UI.Timer)',
2321
+ sim_tab_widget: '4. Interactive 2-Way Home Widget',
2322
+ sim_hint: 'Click buttons inside the widget to see interactive response!',
2323
+ sim_code_label: 'Declarative TypeScript Code',
2324
+ why_title: 'Why Choose `react-native-live-widgets`?',
2325
+ why_desc: 'A breakthrough architecture that builds Native Widgets 10x faster while preserving maximum runtime performance.',
2326
+ f1_title: 'Zero Swift / Kotlin Coding',
2327
+ f1_desc: 'Author your UI entirely in JavaScript/TypeScript or React JSX. The engine automatically compiles layouts into native ASTs for WidgetKit and RemoteViews.',
2328
+ f2_title: 'Bidirectional AppIntents',
2329
+ f2_desc: 'Home Widget buttons trigger JavaScript callbacks inside React Native via the useWidgetAction() hook without opening the main app.',
2330
+ f3_title: 'Zero-Battery Hardware Timers',
2331
+ f3_desc: 'UI.Timer executes smooth second ticks on Dynamic Island and Home Widgets using native OS hardware clocks without waking up the CPU.',
2332
+ f4_title: 'Realtime Audio Equalizer',
2333
+ f4_desc: 'The only library providing smooth oscillating sound wave animations on Dynamic Island and ongoing notifications for audio and podcast apps.',
2334
+ f5_title: 'Background API Sync When Killed',
2335
+ f5_desc: 'Widget.setRemoteConfig() lets the operating system autonomously fetch JSON from remote REST endpoints and update widgets even when the app is force-closed.',
2336
+ f6_title: 'AI Agent Standard (llms.txt)',
2337
+ f6_desc: '100% optimized for Claude Code, ChatGPT, Cursor, and Antigravity through llms.txt and SKILL.md. Your coding agent can build error-free widgets.',
2338
+ dsl_image_title: 'Images & System Icons: <code>UI.Image</code> & <code>&lt;Image&gt;</code>',
2339
+ dsl_image_desc: 'Supports <strong>5 image sources</strong>: <code>url</code> (auto-downloaded, downscaled to 360px max dimension, and cached), <code>base64</code> (QR/Barcode), <code>systemName</code>, <code>assetName</code>, and <code>filePath</code>. Features dedicated cross-platform props <code>systemNameIos</code> (Apple SF Symbols) and <code>systemNameAndroid</code> (Google Material Icons) with full TypeScript auto-complete.',
2340
+ side_quick_start: 'All-in-One CLI Setup',
2341
+ side_expo_setup: 'Expo (Config Plugin & CNG)',
2342
+ side_bare_rn: 'Bare React Native CLI',
2343
+ side_jsx_support: 'JSX / TSX & StyleSheet Syntax',
2344
+ side_widget_preview: '<WidgetPreview> Simulation',
2345
+ side_exact_hit: 'Exact Hit Layer & Chronometer (v1.2.1)',
2346
+ side_dsl_image: 'UI.Image & System Icons (Apple / Google)',
2347
+ footer_dev: 'react-native-live-widgets — Developed by <strong>Vu Tran</strong>',
2348
+ footer_sub: 'MIT Open Source License • Production Ready',
2349
+ }
2350
+ };
2351
+
2352
+ let currentLang = 'vi';
2353
+
2354
+ function switchLanguage(lang) {
2355
+ currentLang = lang;
2356
+ try {
2357
+ localStorage.setItem('rn_live_widgets_lang', lang);
2358
+ } catch (_e) {}
2359
+ document.documentElement.lang = lang;
2360
+
2361
+ const dict = translations[lang] || translations.vi;
2362
+ document.querySelectorAll('[data-i18n]').forEach(el => {
2363
+ const key = el.getAttribute('data-i18n');
2364
+ if (dict[key]) {
2365
+ el.innerHTML = dict[key];
2366
+ }
2367
+ });
2368
+
2369
+ // Update button toggle style
2370
+ const btnVi = document.getElementById('lang-btn-vi');
2371
+ const btnEn = document.getElementById('lang-btn-en');
2372
+ if (btnVi && btnEn) {
2373
+ if (lang === 'vi') {
2374
+ btnVi.className = 'px-2 py-0.5 rounded-md transition text-sky-400 bg-sky-500/20 shadow-sm font-bold';
2375
+ btnEn.className = 'px-2 py-0.5 rounded-md transition text-slate-400 hover:text-white font-normal';
2376
+ } else {
2377
+ btnVi.className = 'px-2 py-0.5 rounded-md transition text-slate-400 hover:text-white font-normal';
2378
+ btnEn.className = 'px-2 py-0.5 rounded-md transition text-sky-400 bg-sky-500/20 shadow-sm font-bold';
2379
+ }
2380
+ }
2381
+ }
2382
+
2383
+ // Scroll to top button visibility & Sidebar ScrollSpy
2384
+ function updateActiveSidebarLink() {
2385
+ const links = Array.from(document.querySelectorAll('#docs-sidebar a.sidebar-link'));
2386
+ if (!links.length) return;
2387
+
2388
+ const offset = 120;
2389
+ let activeId = links[0].getAttribute('href').slice(1);
2390
+
2391
+ for (const link of links) {
2392
+ const href = link.getAttribute('href');
2393
+ if (!href || !href.startsWith('#')) continue;
2394
+ const id = href.slice(1);
2395
+ const target = document.getElementById(id);
2396
+ if (target && target.getBoundingClientRect().top <= offset) {
2397
+ activeId = id;
2398
+ }
2399
+ }
2400
+
2401
+ links.forEach(link => {
2402
+ const isMatch = link.getAttribute('href') === '#' + activeId;
2403
+ if (isMatch) {
2404
+ link.classList.add('bg-sky-500/15', 'text-sky-300', 'font-semibold', 'rounded-md', 'px-2', '-mx-2');
2405
+ } else {
2406
+ link.classList.remove('bg-sky-500/15', 'text-sky-300', 'font-semibold', 'rounded-md', 'px-2', '-mx-2');
2407
+ }
2408
+ });
2409
+ }
2410
+
2411
+ window.addEventListener('scroll', () => {
2412
+ const topBtn = document.getElementById('back-to-top');
2413
+ if (window.scrollY > 400) {
2414
+ topBtn.classList.remove('opacity-0', 'pointer-events-none');
2415
+ topBtn.classList.add('opacity-100');
2416
+ } else {
2417
+ topBtn.classList.add('opacity-0', 'pointer-events-none');
2418
+ topBtn.classList.remove('opacity-100');
2419
+ }
2420
+ updateActiveSidebarLink();
2421
+ }, { passive: true });
2422
+
2423
+ // Initialize initial state
2424
+ document.addEventListener('DOMContentLoaded', () => {
2425
+ lucide.createIcons();
2426
+ if (typeof Prism !== 'undefined') {
2427
+ Prism.highlightAll();
2428
+ }
2429
+ switchSimulator('delivery');
2430
+ updateActiveSidebarLink();
2431
+ try {
2432
+ const savedLang = localStorage.getItem('rn_live_widgets_lang') || 'vi';
2433
+ switchLanguage(savedLang);
2434
+ } catch (_e) {}
2435
+ });
438
2436
  </script>
439
2437
  </body>
440
2438
  </html>