@livx.cc/appwrap 0.39.2 → 0.39.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livx.cc/appwrap",
-  "version": "0.39.2",
+  "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> {

package/runtime/app/shell/handlers-android.ts

@@ -256,8 +256,12 @@ export function registerAndroidHandlers(): void {
   let motionListener: android.hardware.SensorEventListener | null = null;
   const lastMotion = { ax: 0, ay: 0, az: 0, rx: 0, ry: 0, rz: 0 };
 
-  bridge.register('motion.start', () => {
+  bridge.register('motion.start', (p: { hz?: number } = {}) => {
     if (motionListener) return; // already streaming
+    // Emit rate configurable (default 10 Hz; up to 60 for crisp tilt). SENSOR_DELAY_GAME feeds ~50 Hz;
+    // we throttle the EMIT to the requested rate. Higher Hz = more bridge traffic/battery.
+    const hz = Math.max(5, Math.min(60, p.hz || 10));
+    const minMs = 1000 / hz;
     const sm = sensorManager();
     const accel = sm.getDefaultSensor(android.hardware.Sensor.TYPE_ACCELEROMETER);
     if (!accel) throw err('UNSUPPORTED', 'No accelerometer on this device');
@@ -274,12 +278,13 @@ export function registerAndroidHandlers(): void {
           lastMotion.rx = v[0]; lastMotion.ry = v[1]; lastMotion.rz = v[2];
         }
         const now = java.lang.System.currentTimeMillis();
-        if (now - last < 100) return; // ~10Hz, matches iOS
+        if (now - last < minMs) return; // throttle emit to the requested Hz
         last = now;
         bridge.emit('motion.data', { ...lastMotion });
       },
     });
-    const RATE = android.hardware.SensorManager.SENSOR_DELAY_GAME;
+    const RATE = hz > 30 ? android.hardware.SensorManager.SENSOR_DELAY_FASTEST
+                         : android.hardware.SensorManager.SENSOR_DELAY_GAME;
     sm.registerListener(motionListener, accel, RATE);
     if (gyro) sm.registerListener(motionListener, gyro, RATE);
   });

package/runtime/app/shell/handlers-parity.ts

@@ -172,13 +172,18 @@ export function registerParityHandlers(): void {
   let motionManager: CMMotionManager | null = null;
   let motionTimer: ReturnType<typeof setInterval> | null = null;
 
-  bridge.register('motion.start', () => {
+  bridge.register('motion.start', (p: { hz?: number } = {}) => {
     if (!isIOS) throw iosOnly();
     if (motionManager) return;
+    // Emit rate is configurable (default 10 Hz; games can ask up to 60 for crisp tilt). Both the JS
+    // poll cadence AND the CoreMotion sample interval are set — the poll is the actual emit rate, so
+    // bumping deviceMotionUpdateInterval alone wouldn't help. Higher Hz = more bridge traffic/battery.
+    const hz = Math.max(5, Math.min(60, p.hz || 10));
+    const ms = 1000 / hz;
     const mm = CMMotionManager.new();
     if (!mm.deviceMotionAvailable) throw err('UNSUPPORTED', 'No motion sensors (simulator?)');
     motionManager = mm;
-    mm.deviceMotionUpdateInterval = 0.1;
+    mm.deviceMotionUpdateInterval = ms / 1000;
     mm.startDeviceMotionUpdates();
     const G = 9.81; // CoreMotion reports in g — kit contract is m/s²
     motionTimer = setInterval(() => {
@@ -192,7 +197,7 @@ export function registerParityHandlers(): void {
         ry: m.rotationRate.y,
         rz: m.rotationRate.z,
       });
-    }, 100);
+    }, ms);
   });
 
   bridge.register('motion.stop', () => {