@livx.cc/appwrap 0.39.3 → 0.39.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livx.cc/appwrap",
-  "version": "0.39.3",
+  "version": "0.39.4",
   "description": "Wrap any PWA into a native app with native capabilities (appwrap runtime + @livx.cc/native-kit).",
   "license": "MIT",
   "author": "Elya Livshitz",

package/runtime/app/shell/devmenu.ts

@@ -5,9 +5,10 @@ import { SHELL_BUILD, reloadWebView, getReportedWebVersion } from './handlers';
 
 /**
  * Shake-to-open developer menu (enabled in prod too, gated by `SHELL_CONFIG.devMenu`).
- * A shake raises a native action sheet → "App Info" shows non-sensitive diagnostics
- * (ids, versions, loader, remote host) including the running webapp's version vs. the
- * latest deployed — so you can tell at a glance whether the device got the update.
+ * A shake raises a native action sheet with: "App Info" — non-sensitive diagnostics (ids, versions,
+ * loader, remote host) including the running webapp's version vs. the latest deployed, so you can tell
+ * at a glance whether the device got the update; "Reload"; and "Toggle Debug" — a generic hook that
+ * dispatches the `appwrap:toggleDebug` DOM event so the web app can flip its OWN debug UI.
  * The web version status is reported via the always-on `app.reportWebVersion` handler
  * (in handlers.ts) — independent of this menu — and read here when the menu is shown.
  */
@@ -120,10 +121,11 @@ async function showDevMenu(): Promise<void> {
       title: SHELL_CONFIG.name,
       message: 'Developer menu',
       cancelButtonText: 'Cancel',
-      actions: ['App Info', 'Reload'],
+      actions: ['App Info', 'Reload', 'Toggle Debug'],
     });
     if (action === 'App Info') await showInfo();
     else if (action === 'Reload') reloadWebView();
+    else if (action === 'Toggle Debug') toggleWebDebug();
   } finally {
     menuOpen = false;
   }
@@ -152,6 +154,15 @@ async function showInfo(): Promise<void> {
   Dialogs.alert({ title: 'App Info', message: lines.join('\n'), okButtonText: 'Close' });
 }
 
+/** Generic dev hook: dispatch a DOM event the running web app can listen for to flip its OWN debug UI
+ * (`window.addEventListener('appwrap:toggleDebug', …)`). No-op for apps that don't listen — the shell
+ * has no app-specific debug state of its own, so it just relays the intent. */
+function toggleWebDebug(): void {
+  bridge
+    .evalJs("window.dispatchEvent(new CustomEvent('appwrap:toggleDebug'))")
+    .catch((e) => console.log('[appwrap] toggleDebug dispatch failed:', e));
+}
+
 /** Read the running page's embedded version directly from the WebView: `window.__APP_VERSION__`,
  * then a `<meta name="app-version">` fallback. '' if neither is present (or eval fails). */
 async function readPageVersion(): Promise<string> {