@aippy/runtime 0.2.3 → 0.2.4-dev.2

package/dist/device/index.js

@@ -1,10 +1,10 @@
-var h = Object.defineProperty;
-var p = (n, e, t) => e in n ? h(n, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : n[e] = t;
-var m = (n, e, t) => p(n, typeof e != "symbol" ? e + "" : e, t);
-import { c as a } from "../errors-CDEBaBxB.js";
-class g {
+var U = Object.defineProperty;
+var M = (n, e, t) => e in n ? U(n, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : n[e] = t;
+var A = (n, e, t) => M(n, typeof e != "symbol" ? e + "" : e, t);
+import { c as s, b as L } from "../runtime-DjBdOttl.js";
+class k {
   constructor() {
-    m(this, "stream", null);
+    A(this, "stream", null);
   }
   /**
    * Check if camera is supported
@@ -17,7 +17,7 @@ class g {
    */
   async getStream(e = {}) {
     if (!this.isSupported())
-      throw a("Camera API is not supported", "NOT_SUPPORTED");
+      throw s("Camera API is not supported", "NOT_SUPPORTED");
     try {
       const t = {
         video: {
@@ -28,7 +28,7 @@ class g {
       };
       return this.stream = await navigator.mediaDevices.getUserMedia(t), this.stream;
     } catch (t) {
-      throw a(
+      throw s(
         `Failed to access camera: ${t instanceof Error ? t.message : "Unknown error"}`,
         "PERMISSION_DENIED"
       );
@@ -39,27 +39,27 @@ class g {
    */
   async capturePhoto(e = {}) {
     if (!this.stream)
-      throw a("No camera stream available", "NOT_SUPPORTED");
+      throw s("No camera stream available", "NOT_SUPPORTED");
     try {
       const t = document.createElement("video");
       t.srcObject = this.stream, t.play();
-      const o = document.createElement("canvas"), i = o.getContext("2d");
-      if (!i)
-        throw a("Failed to get canvas context", "UNKNOWN_ERROR");
-      o.width = e.width || t.videoWidth, o.height = e.height || t.videoHeight, i.drawImage(t, 0, 0, o.width, o.height);
-      const r = e.format || "jpeg", c = e.quality === "high" ? 0.9 : e.quality === "medium" ? 0.7 : 0.5, s = await new Promise((u, w) => {
-        o.toBlob((l) => {
-          l ? u(l) : w(new Error("Failed to create blob"));
+      const i = document.createElement("canvas"), o = i.getContext("2d");
+      if (!o)
+        throw s("Failed to get canvas context", "UNKNOWN_ERROR");
+      i.width = e.width || t.videoWidth, i.height = e.height || t.videoHeight, o.drawImage(t, 0, 0, i.width, i.height);
+      const r = e.format || "jpeg", c = e.quality === "high" ? 0.9 : e.quality === "medium" ? 0.7 : 0.5, a = await new Promise((u, m) => {
+        i.toBlob((l) => {
+          l ? u(l) : m(new Error("Failed to create blob"));
         }, `image/${r}`, c);
-      }), d = o.toDataURL(`image/${r}`, c);
+      }), d = i.toDataURL(`image/${r}`, c);
       return {
-        blob: s,
+        blob: a,
         dataUrl: d,
-        width: o.width,
-        height: o.height
+        width: i.width,
+        height: i.height
       };
     } catch (t) {
-      throw a(
+      throw s(
         `Failed to capture photo: ${t instanceof Error ? t.message : "Unknown error"}`,
         "UNKNOWN_ERROR"
       );
@@ -72,8 +72,8 @@ class g {
     this.stream && (this.stream.getTracks().forEach((e) => e.stop()), this.stream = null);
   }
 }
-const f = new g();
-class v {
+const H = new k();
+class T {
   /**
    * Check if geolocation is supported
    */
@@ -85,9 +85,9 @@ class v {
    */
   async getCurrentPosition(e = {}) {
     if (!this.isSupported())
-      throw a("Geolocation API is not supported", "NOT_SUPPORTED");
-    return new Promise((t, o) => {
-      const i = {
+      throw s("Geolocation API is not supported", "NOT_SUPPORTED");
+    return new Promise((t, i) => {
+      const o = {
         enableHighAccuracy: e.enableHighAccuracy ?? !0,
         timeout: e.timeout ?? 1e4,
         maximumAge: e.maximumAge ?? 6e4
@@ -107,21 +107,21 @@ class v {
           t(c);
         },
         (r) => {
-          let c = "UNKNOWN_ERROR", s = "Unknown geolocation error";
+          let c = "UNKNOWN_ERROR", a = "Unknown geolocation error";
           switch (r.code) {
             case r.PERMISSION_DENIED:
-              c = "PERMISSION_DENIED", s = "Geolocation permission denied";
+              c = "PERMISSION_DENIED", a = "Geolocation permission denied";
               break;
             case r.POSITION_UNAVAILABLE:
-              s = "Position unavailable";
+              a = "Position unavailable";
               break;
             case r.TIMEOUT:
-              s = "Geolocation timeout";
+              a = "Geolocation timeout";
               break;
           }
-          o(a(s, c));
+          i(s(a, c));
         },
-        i
+        o
       );
     });
   }
@@ -130,30 +130,30 @@ class v {
    */
   watchPosition(e, t = {}) {
     if (!this.isSupported())
-      throw a("Geolocation API is not supported", "NOT_SUPPORTED");
-    const o = {
+      throw s("Geolocation API is not supported", "NOT_SUPPORTED");
+    const i = {
       enableHighAccuracy: t.enableHighAccuracy ?? !0,
       timeout: t.timeout ?? 1e4,
       maximumAge: t.maximumAge ?? 6e4
     };
     return navigator.geolocation.watchPosition(
-      (i) => {
+      (o) => {
         const r = {
-          latitude: i.coords.latitude,
-          longitude: i.coords.longitude,
-          accuracy: i.coords.accuracy,
-          altitude: i.coords.altitude ?? void 0,
-          altitudeAccuracy: i.coords.altitudeAccuracy ?? void 0,
-          heading: i.coords.heading ?? void 0,
-          speed: i.coords.speed ?? void 0,
-          timestamp: i.timestamp
+          latitude: o.coords.latitude,
+          longitude: o.coords.longitude,
+          accuracy: o.coords.accuracy,
+          altitude: o.coords.altitude ?? void 0,
+          altitudeAccuracy: o.coords.altitudeAccuracy ?? void 0,
+          heading: o.coords.heading ?? void 0,
+          speed: o.coords.speed ?? void 0,
+          timestamp: o.timestamp
         };
         e(r);
       },
-      (i) => {
-        console.error("Geolocation watch error:", i);
+      (o) => {
+        console.error("Geolocation watch error:", o);
       },
-      o
+      i
     );
   }
   /**
@@ -163,51 +163,211 @@ class v {
     navigator.geolocation.clearWatch(e);
   }
 }
-const N = new v();
-class E {
+const q = new T();
+function f() {
+  return "DeviceMotionEvent" in window;
+}
+function N() {
+  return "DeviceOrientationEvent" in window;
+}
+function R() {
+  const n = typeof window < "u", e = n && !!window.webkit, t = e && !!window.webkit?.messageHandlers, i = t && !!window.webkit?.messageHandlers?.aippyListener;
+  return console.log("🔍 [Aippy Sensors] hasNativeBridge check:", {
+    hasWindow: n,
+    hasWebkit: e,
+    hasMessageHandlers: t,
+    hasAippyListener: i,
+    result: i
+  }), i;
+}
+function I() {
+  return typeof window < "u" && typeof window.orientation < "u" ? window.orientation : typeof window < "u" && window.screen?.orientation?.angle !== void 0 ? window.screen.orientation.angle : 0;
+}
+function y(n, e, t) {
+  switch (t) {
+    case 0:
+      return [n, e];
+    case 180:
+      return [-n, -e];
+    case 90:
+      return [-e, n];
+    case -90:
+      return [e, -n];
+    default:
+      return [n, e];
+  }
+}
+async function b() {
+  if (console.log("🔐 [Aippy Sensors] requestMotionPermission called"), R())
+    return console.log("✅ [Aippy Sensors] Native bridge available, skipping permission request"), !0;
+  if (!f())
+    return console.warn("❌ [Aippy Sensors] Device motion not supported"), !1;
+  const n = typeof DeviceMotionEvent < "u" && typeof DeviceMotionEvent.requestPermission == "function";
+  if (console.log("🔍 [Aippy Sensors] Permission API available:", n), n)
+    try {
+      console.log("🙏 [Aippy Sensors] Requesting device motion permission...");
+      const e = await DeviceMotionEvent.requestPermission();
+      return console.log("📋 [Aippy Sensors] Permission result:", e), e === "granted";
+    } catch (e) {
+      return console.warn("❌ [Aippy Sensors] Permission request failed:", e), !1;
+    }
+  return console.log("✅ [Aippy Sensors] No permission needed (granted by default)"), !0;
+}
+function _(n) {
+  console.log("🔧 [Aippy Sensors] watchMotionNative - Setting up native bridge listener");
+  const e = L.addMotionListener((t) => {
+    const i = I(), o = t.gravity?.x ?? 0, r = t.gravity?.y ?? 0, c = t.gravity?.z ?? 0, a = t.acceleration?.x ?? 0, d = t.acceleration?.y ?? 0, u = t.acceleration?.z ?? 0, [m, l] = y(o, r, i), [g, h] = y(a, d, i), v = {
+      gravity: {
+        x: m,
+        y: l,
+        z: c
+        // Z轴不受屏幕旋转影响
+      },
+      acceleration: {
+        x: g,
+        y: h,
+        z: u
+        // Z轴不受屏幕旋转影响
+      },
+      accelerationIncludingGravity: {
+        x: m + g,
+        y: l + h,
+        z: c + u
+      },
+      rotation: {
+        alpha: t.rotation?.alpha ?? 0,
+        beta: t.rotation?.beta ?? 0,
+        gamma: t.rotation?.gamma ?? 0
+      },
+      timestamp: Date.now()
+    };
+    n(v);
+  });
+  return console.log("✅ [Aippy Sensors] watchMotionNative - Listener setup complete"), e;
+}
+function F(n, e = !0) {
+  if (!f())
+    throw s("Device motion API is not supported", "NOT_SUPPORTED");
+  let t = !1, i = null;
+  const o = (a) => {
+    if (!t) return;
+    const d = I();
+    let u, m, l;
+    if (a.acceleration) {
+      const w = a.accelerationIncludingGravity, p = a.acceleration;
+      u = (w?.x ?? 0) - (p?.x ?? 0), m = (w?.y ?? 0) - (p?.y ?? 0), l = (w?.z ?? 0) - (p?.z ?? 0);
+    } else {
+      const w = a.accelerationIncludingGravity, p = 9.8;
+      u = (w?.x ?? 0) / p, m = (w?.y ?? 0) / p, l = (w?.z ?? 0) / p;
+    }
+    const g = a.acceleration?.x ?? 0, h = a.acceleration?.y ?? 0, v = a.acceleration?.z ?? 0, [E, P] = y(u, m, d), [O, S] = y(g, h, d), D = {
+      gravity: {
+        x: E,
+        y: P,
+        z: l
+        // Z轴不受屏幕旋转影响
+      },
+      acceleration: {
+        x: O,
+        y: S,
+        z: v
+        // Z轴不受屏幕旋转影响
+      },
+      accelerationIncludingGravity: {
+        x: E + O,
+        y: P + S,
+        z: l + v
+      },
+      rotation: {
+        alpha: a.rotationRate?.alpha ?? 0,
+        beta: a.rotationRate?.beta ?? 0,
+        gamma: a.rotationRate?.gamma ?? 0
+      },
+      timestamp: Date.now()
+    };
+    n(D);
+  }, r = async () => {
+    e && !await b() || (t = !0, window.addEventListener("devicemotion", o));
+  };
+  return (async () => {
+    if (typeof DeviceMotionEvent < "u" && typeof DeviceMotionEvent.requestPermission == "function" && e) {
+      const d = async () => {
+        i = null, await r();
+      };
+      window.addEventListener("click", d, { once: !0 }), window.addEventListener("touchstart", d, { once: !0 }), i = () => {
+        window.removeEventListener("click", d), window.removeEventListener("touchstart", d);
+      };
+    } else
+      await r();
+  })(), () => {
+    t = !1, window.removeEventListener("devicemotion", o), i && (i(), i = null);
+  };
+}
+function C(n, e = !0) {
+  const t = R();
+  return console.log(`🎯 [Aippy Sensors] watchMotion - Using ${t ? "NATIVE BRIDGE" : "WEB API"} mode`), t ? (console.log("📱 [Aippy Sensors] Starting native bridge motion listener"), _(n)) : (console.log("🌐 [Aippy Sensors] Starting Web API motion listener (may require permission)"), F(n, e));
+}
+function B(n) {
+  if (!N())
+    throw s("Device orientation API is not supported", "NOT_SUPPORTED");
+  const e = (t) => {
+    const i = {
+      alpha: t.alpha ?? 0,
+      beta: t.beta ?? 0,
+      gamma: t.gamma ?? 0,
+      timestamp: Date.now()
+    };
+    n(i);
+  };
+  return window.addEventListener("deviceorientation", e), () => {
+    window.removeEventListener("deviceorientation", e);
+  };
+}
+class x {
   /**
    * Check if device orientation is supported
    */
   isOrientationSupported() {
-    return "DeviceOrientationEvent" in window;
+    return N();
   }
   /**
    * Check if device motion is supported
    */
   isMotionSupported() {
-    return "DeviceMotionEvent" in window;
+    return f();
   }
   /**
    * Get device orientation data
    */
   async getOrientation() {
     if (!this.isOrientationSupported())
-      throw a("Device orientation API is not supported", "NOT_SUPPORTED");
+      throw s("Device orientation API is not supported", "NOT_SUPPORTED");
     return new Promise((e, t) => {
-      const o = (i) => {
-        window.removeEventListener("deviceorientation", o), e({
-          x: i.alpha ?? 0,
-          y: i.beta ?? 0,
-          z: i.gamma ?? 0,
+      const i = (o) => {
+        window.removeEventListener("deviceorientation", i), e({
+          x: o.alpha ?? 0,
+          y: o.beta ?? 0,
+          z: o.gamma ?? 0,
           timestamp: Date.now()
         });
       };
-      window.addEventListener("deviceorientation", o), setTimeout(() => {
-        window.removeEventListener("deviceorientation", o), t(a("Device orientation timeout", "UNKNOWN_ERROR"));
+      window.addEventListener("deviceorientation", i), setTimeout(() => {
+        window.removeEventListener("deviceorientation", i), t(s("Device orientation timeout", "UNKNOWN_ERROR"));
       }, 5e3);
     });
   }
   /**
    * Watch device orientation changes
+   * @deprecated Use watchOrientation() function instead
    */
   watchOrientation(e) {
     if (!this.isOrientationSupported())
-      throw a("Device orientation API is not supported", "NOT_SUPPORTED");
-    const t = (o) => {
+      throw s("Device orientation API is not supported", "NOT_SUPPORTED");
+    const t = (i) => {
       e({
-        x: o.alpha ?? 0,
-        y: o.beta ?? 0,
-        z: o.gamma ?? 0,
+        x: i.alpha ?? 0,
+        y: i.beta ?? 0,
+        z: i.gamma ?? 0,
         timestamp: Date.now()
       });
     };
@@ -220,32 +380,33 @@ class E {
    */
   async getMotion() {
     if (!this.isMotionSupported())
-      throw a("Device motion API is not supported", "NOT_SUPPORTED");
+      throw s("Device motion API is not supported", "NOT_SUPPORTED");
     return new Promise((e, t) => {
-      const o = (i) => {
-        window.removeEventListener("devicemotion", o), e({
-          x: i.acceleration?.x ?? 0,
-          y: i.acceleration?.y ?? 0,
-          z: i.acceleration?.z ?? 0,
+      const i = (o) => {
+        window.removeEventListener("devicemotion", i), e({
+          x: o.acceleration?.x ?? 0,
+          y: o.acceleration?.y ?? 0,
+          z: o.acceleration?.z ?? 0,
           timestamp: Date.now()
         });
       };
-      window.addEventListener("devicemotion", o), setTimeout(() => {
-        window.removeEventListener("devicemotion", o), t(a("Device motion timeout", "UNKNOWN_ERROR"));
+      window.addEventListener("devicemotion", i), setTimeout(() => {
+        window.removeEventListener("devicemotion", i), t(s("Device motion timeout", "UNKNOWN_ERROR"));
       }, 5e3);
     });
   }
   /**
    * Watch device motion changes
+   * @deprecated Use watchMotion() function instead
    */
   watchMotion(e) {
     if (!this.isMotionSupported())
-      throw a("Device motion API is not supported", "NOT_SUPPORTED");
-    const t = (o) => {
+      throw s("Device motion API is not supported", "NOT_SUPPORTED");
+    const t = (i) => {
       e({
-        x: o.acceleration?.x ?? 0,
-        y: o.acceleration?.y ?? 0,
-        z: o.acceleration?.z ?? 0,
+        x: i.acceleration?.x ?? 0,
+        y: i.acceleration?.y ?? 0,
+        z: i.acceleration?.z ?? 0,
         timestamp: Date.now()
       });
     };
@@ -257,17 +418,11 @@ class E {
    * Request permission for motion sensors (iOS 13+)
    */
   async requestPermission() {
-    if (!this.isMotionSupported())
-      return !1;
-    try {
-      return (await navigator.permissions?.query({ name: "accelerometer" }))?.state === "granted";
-    } catch {
-      return !1;
-    }
+    return b();
   }
 }
-const R = new E();
-class O {
+const K = new x();
+class G {
   /**
    * Check if file system access is supported
    */
@@ -285,7 +440,7 @@ class O {
    */
   async openFilePicker(e = {}) {
     if (!this.isSupported())
-      throw a("File System Access API is not supported", "NOT_SUPPORTED");
+      throw s("File System Access API is not supported", "NOT_SUPPORTED");
     try {
       const t = {
         types: e.accept ? [{
@@ -295,15 +450,15 @@ class O {
           )
         }] : void 0,
         multiple: e.multiple ?? !1
-      }, o = await window.showOpenFilePicker(t), i = await Promise.all(
-        o.map(async (r) => r.getFile())
+      }, i = await window.showOpenFilePicker(t), o = await Promise.all(
+        i.map(async (r) => r.getFile())
       );
       return {
-        files: i,
-        paths: i.map((r) => r.name)
+        files: o,
+        paths: o.map((r) => r.name)
       };
     } catch (t) {
-      throw t instanceof Error && t.name === "AbortError" ? a("File picker was cancelled", "PERMISSION_DENIED") : a(
+      throw t instanceof Error && t.name === "AbortError" ? s("File picker was cancelled", "PERMISSION_DENIED") : s(
         `Failed to open file picker: ${t instanceof Error ? t.message : "Unknown error"}`,
         "PERMISSION_DENIED"
       );
@@ -314,18 +469,18 @@ class O {
    */
   async openFilePickerLegacy(e = {}) {
     if (!this.isLegacySupported())
-      throw a("File input is not supported", "NOT_SUPPORTED");
-    return new Promise((t, o) => {
-      const i = document.createElement("input");
-      i.type = "file", i.multiple = e.multiple ?? !1, i.accept = e.accept?.join(",") ?? "", i.onchange = (r) => {
-        const c = r.target, s = Array.from(c.files || []);
+      throw s("File input is not supported", "NOT_SUPPORTED");
+    return new Promise((t, i) => {
+      const o = document.createElement("input");
+      o.type = "file", o.multiple = e.multiple ?? !1, o.accept = e.accept?.join(",") ?? "", o.onchange = (r) => {
+        const c = r.target, a = Array.from(c.files || []);
         t({
-          files: s,
-          paths: s.map((d) => d.name)
+          files: a,
+          paths: a.map((d) => d.name)
         });
-      }, i.oncancel = () => {
-        o(a("File picker was cancelled", "PERMISSION_DENIED"));
-      }, i.click();
+      }, o.oncancel = () => {
+        i(s("File picker was cancelled", "PERMISSION_DENIED"));
+      }, o.click();
     });
   }
   /**
@@ -339,11 +494,11 @@ class O {
    */
   async saveFile(e, t) {
     try {
-      const o = URL.createObjectURL(e), i = document.createElement("a");
-      i.href = o, i.download = t, document.body.appendChild(i), i.click(), document.body.removeChild(i), URL.revokeObjectURL(o);
-    } catch (o) {
-      throw a(
-        `Failed to save file: ${o instanceof Error ? o.message : "Unknown error"}`,
+      const i = URL.createObjectURL(e), o = document.createElement("a");
+      o.href = i, o.download = t, document.body.appendChild(o), o.click(), document.body.removeChild(o), URL.revokeObjectURL(i);
+    } catch (i) {
+      throw s(
+        `Failed to save file: ${i instanceof Error ? i.message : "Unknown error"}`,
         "UNKNOWN_ERROR"
       );
     }
@@ -352,23 +507,23 @@ class O {
    * Read file as text
    */
   async readAsText(e) {
-    return new Promise((t, o) => {
-      const i = new FileReader();
-      i.onload = () => t(i.result), i.onerror = () => o(a("Failed to read file", "UNKNOWN_ERROR")), i.readAsText(e);
+    return new Promise((t, i) => {
+      const o = new FileReader();
+      o.onload = () => t(o.result), o.onerror = () => i(s("Failed to read file", "UNKNOWN_ERROR")), o.readAsText(e);
     });
   }
   /**
    * Read file as data URL
    */
   async readAsDataURL(e) {
-    return new Promise((t, o) => {
-      const i = new FileReader();
-      i.onload = () => t(i.result), i.onerror = () => o(a("Failed to read file", "UNKNOWN_ERROR")), i.readAsDataURL(e);
+    return new Promise((t, i) => {
+      const o = new FileReader();
+      o.onload = () => t(o.result), o.onerror = () => i(s("Failed to read file", "UNKNOWN_ERROR")), o.readAsDataURL(e);
     });
   }
 }
-const S = new O();
-function D(n) {
+const X = new G();
+function Y(n) {
   return new Promise((e) => {
     if ("vibrate" in navigator)
       navigator.vibrate(n), e();
@@ -383,13 +538,19 @@ function D(n) {
   });
 }
 export {
-  g as CameraAPI,
-  O as FileSystemAPI,
-  v as GeolocationAPI,
-  E as SensorsAPI,
-  f as camera,
-  S as fileSystem,
-  N as geolocation,
-  R as sensors,
-  D as vibrate
+  k as CameraAPI,
+  G as FileSystemAPI,
+  T as GeolocationAPI,
+  x as SensorsAPI,
+  H as camera,
+  X as fileSystem,
+  q as geolocation,
+  R as hasNativeBridge,
+  f as isMotionSupported,
+  N as isOrientationSupported,
+  b as requestMotionPermission,
+  K as sensors,
+  Y as vibrate,
+  C as watchMotion,
+  B as watchOrientation
 };

package/dist/device/sensors.d.ts

@@ -1,6 +1,39 @@
-import { SensorData } from './types';
+import { SensorData, MotionData, OrientationData } from './types';
 /**
- * Device sensors functionality wrapper
+ * Check if device motion is supported
+ */
+export declare function isMotionSupported(): boolean;
+/**
+ * Check if device orientation is supported
+ */
+export declare function isOrientationSupported(): boolean;
+/**
+ * Check if native bridge is available
+ */
+export declare function hasNativeBridge(): boolean;
+/**
+ * Request permission for motion sensors (iOS 13+)
+ * @returns Promise<boolean> - true if permission granted
+ */
+export declare function requestMotionPermission(): Promise<boolean>;
+/**
+ * Watch device motion changes with full motion data
+ * Automatically uses native bridge if available, otherwise falls back to Web API
+ *
+ * @param callback - Function to call with motion data
+ * @param autoRequestPermission - Automatically request permission on iOS (default: true, only for Web API)
+ * @returns Cleanup function to stop watching
+ */
+export declare function watchMotion(callback: (data: MotionData) => void, autoRequestPermission?: boolean): () => void;
+/**
+ * Watch device orientation changes
+ * @param callback - Function to call with orientation data
+ * @returns Cleanup function to stop watching
+ */
+export declare function watchOrientation(callback: (data: OrientationData) => void): () => void;
+/**
+ * Legacy SensorsAPI class for backward compatibility
+ * @deprecated Use watchMotion() and watchOrientation() functions instead
  */
 export declare class SensorsAPI {
     /**
@@ -17,6 +50,7 @@ export declare class SensorsAPI {
     getOrientation(): Promise<SensorData>;
     /**
      * Watch device orientation changes
+     * @deprecated Use watchOrientation() function instead
      */
     watchOrientation(callback: (data: SensorData) => void): () => void;
     /**
@@ -25,6 +59,7 @@ export declare class SensorsAPI {
     getMotion(): Promise<SensorData>;
     /**
      * Watch device motion changes
+     * @deprecated Use watchMotion() function instead
      */
     watchMotion(callback: (data: SensorData) => void): () => void;
     /**
@@ -33,6 +68,7 @@ export declare class SensorsAPI {
     requestPermission(): Promise<boolean>;
 }
 /**
- * Sensors API instance
+ * Sensors API instance (for backward compatibility)
+ * @deprecated Use watchMotion() and watchOrientation() functions instead
  */
 export declare const sensors: SensorsAPI;