@symbiote-native/sensors 0.1.0 → 0.2.1

package/README.md

@@ -38,8 +38,8 @@ package with zero further changes:
 
 Full mechanics — the Podfile pieces that normally ship inside the `expo` package, the `expo`
 peer-dependency exclusion list, per-sensor permission strings — live in the
-`symbiote-expo-native-module` skill. Reference implementation: `.examples/react/ios/Podfile` and
-`.examples/react/android/app/src/main/java/com/canary/MainApplication.kt`.
+`symbiote-expo-native-module` skill. Reference implementation: `examples/expo-react/ios/Podfile`
+and `examples/expo-react/android/app/src/main/java/com/canaryexpo/MainApplication.kt`.
 
 Permissions ship with the native module itself — nothing to reimplement, just the platform
 permission string each sensor needs (e.g. DeviceMotion/Pedometer need `NSMotionUsageDescription`
@@ -99,9 +99,9 @@ export class SensorsScreen {
 }
 ```
 
-The React example above mirrors the real demo screen, `.examples/react/screens/SensorsScreen.tsx`
-— the Vue and Angular snippets are illustrative; those adapters' own demo screens aren't wired up
-yet (React is this repo's "prove the pattern first" adapter for this package).
+All three examples above mirror the real canary demo screens —
+`examples/expo-react/screens/SensorsScreen.tsx`, `examples/expo-vue-sfc/screens/SensorsScreen.vue`,
+`examples/expo-vue-tsx/screens/SensorsScreen.tsx`, `examples/expo-angular/src/screens/SensorsScreen.ts`.
 
 Every hook/composable/`connect()` takes an optional `updateIntervalMs` and returns `null` until the
 first native reading arrives — check `isAvailableAsync()` separately if you need to distinguish

package/native-link.json

@@ -0,0 +1,52 @@
+{
+  "android": {
+    "gradleProjectName": "expo-sensors",
+    "modules": [
+      {
+        "importPath": "expo.modules.sensors.modules.AccelerometerModule",
+        "className": "AccelerometerModule",
+        "nativeName": "ExponentAccelerometer"
+      },
+      {
+        "importPath": "expo.modules.sensors.modules.BarometerModule",
+        "className": "BarometerModule",
+        "nativeName": "ExpoBarometer"
+      },
+      {
+        "importPath": "expo.modules.sensors.modules.DeviceMotionModule",
+        "className": "DeviceMotionModule",
+        "nativeName": "ExponentDeviceMotion"
+      },
+      {
+        "importPath": "expo.modules.sensors.modules.GyroscopeModule",
+        "className": "GyroscopeModule",
+        "nativeName": "ExponentGyroscope"
+      },
+      {
+        "importPath": "expo.modules.sensors.modules.LightSensorModule",
+        "className": "LightSensorModule",
+        "nativeName": "ExpoLightSensor"
+      },
+      {
+        "importPath": "expo.modules.sensors.modules.MagnetometerModule",
+        "className": "MagnetometerModule",
+        "nativeName": "ExponentMagnetometer"
+      },
+      {
+        "importPath": "expo.modules.sensors.modules.MagnetometerUncalibratedModule",
+        "className": "MagnetometerUncalibratedModule",
+        "nativeName": "ExponentMagnetometerUncalibrated"
+      },
+      {
+        "importPath": "expo.modules.sensors.modules.PedometerModule",
+        "className": "PedometerModule",
+        "nativeName": "ExponentPedometer"
+      }
+    ]
+  },
+  "ios": {
+    "infoPlistKeys": {
+      "NSMotionUsageDescription": "This app uses motion sensor data."
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbiote-native/sensors",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "expo-sensors wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, and Angular adapters. Accelerometer, Barometer, DeviceMotion, Gyroscope, LightSensor, Magnetometer, MagnetometerUncalibrated, Pedometer.",
   "license": "MIT",
   "repository": {
@@ -39,7 +39,11 @@
   "files": [
     "src",
     "build",
-    "build-ngc"
+    "build-ngc",
+    "native-link.json",
+    "!src/**/*.test.*",
+    "!src/**/*.spec.*",
+    "!src/**/*.detox.*"
   ],
   "publishConfig": {
     "access": "public"
@@ -55,7 +59,7 @@
     "react": ">=19.0.0",
     "react-native": ">=0.86",
     "vue": ">=3.5.0",
-    "@symbiote-native/angular": "0.6.1",
+    "@symbiote-native/angular": "0.6.2",
     "@symbiote-native/react": "0.2.8",
     "@symbiote-native/vue": "0.3.8"
   },
@@ -91,11 +95,11 @@
     "@vue/runtime-core": "^3.5.13",
     "react": "19.2.3",
     "typescript": "~6.0.0",
-    "@symbiote-native/angular": "0.6.1",
-    "@symbiote-native/vue": "0.3.8",
-    "@symbiote-native/test-utils": "0.1.6",
+    "@symbiote-native/angular": "0.6.2",
     "@symbiote-native/engine": "0.1.7",
-    "@symbiote-native/react": "0.2.8"
+    "@symbiote-native/react": "0.2.8",
+    "@symbiote-native/test-utils": "0.1.6",
+    "@symbiote-native/vue": "0.3.8"
   },
   "scripts": {
     "typecheck": "tsc --build",

package/src/angular/services/accelerometer.service/accelerometer.service.test.ts

@@ -1,118 +0,0 @@
-// Co-located Angular-driven test (ADR 0025) for AccelerometerService. Mounts a real host
-// component through @symbiote-native/angular so `connect()` runs the same way an app would call
-// it — inside the component's own injection context — and drives the returned signal through a
-// full mount/unmount lifecycle, because `effect()`'s injector-scoped cleanup only fires
-// correctly when torn down through a real Angular injection context.
-
-import '@angular/compiler';
-import { Component, inject, type Signal } from '@angular/core';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { mount, unmount } from '@symbiote-native/angular';
-import { installFabric } from '@symbiote-native/test-utils';
-import type { IAccelerometerMeasurement } from '../../../core';
-import { AccelerometerService } from './index';
-
-const addListenerMock = vi.fn();
-const removeMock = vi.fn();
-const setUpdateIntervalMock = vi.fn();
-
-vi.mock('../../../core', () => ({
-  Accelerometer: {
-    addListener: (listener: (measurement: IAccelerometerMeasurement) => void) =>
-      addListenerMock(listener),
-    setUpdateInterval: (intervalMs: number) => setUpdateIntervalMock(intervalMs),
-  },
-}));
-
-const ROOT_TAG = 941;
-const fabric = installFabric();
-const tick = (): Promise<void> => new Promise(resolve => setTimeout(resolve, 0));
-
-const MEASUREMENT: IAccelerometerMeasurement = { x: 0.1, y: 0.2, z: 0.3, timestamp: 123 };
-
-let capturedResult: Signal<IAccelerometerMeasurement | null> | undefined;
-let capturedListener: ((measurement: IAccelerometerMeasurement) => void) | undefined;
-
-@Component({
-  selector: 'symbiote-accelerometer-host',
-  standalone: true,
-  template: '',
-})
-class AccelerometerHost {
-  readonly measurement = inject(AccelerometerService).connect();
-
-  constructor() {
-    capturedResult = this.measurement;
-  }
-}
-
-@Component({
-  selector: 'symbiote-accelerometer-interval-host',
-  standalone: true,
-  template: '',
-})
-class AccelerometerIntervalHost {
-  readonly measurement = inject(AccelerometerService).connect(500);
-
-  constructor() {
-    capturedResult = this.measurement;
-  }
-}
-
-beforeEach(() => {
-  capturedResult = undefined;
-  capturedListener = undefined;
-  addListenerMock.mockImplementation(listener => {
-    capturedListener = listener;
-    return { remove: removeMock };
-  });
-});
-
-afterEach(() => {
-  unmount(ROOT_TAG);
-  fabric.reset();
-  vi.clearAllMocks();
-});
-
-describe('AccelerometerService.connect', () => {
-  it('reports null before any measurement event fires', async () => {
-    mount(ROOT_TAG, AccelerometerHost);
-    await tick();
-
-    expect(capturedResult?.()).toBeNull();
-  });
-
-  it('updates the signal when the registered listener fires with a measurement', async () => {
-    mount(ROOT_TAG, AccelerometerHost);
-    await tick();
-
-    if (capturedListener === undefined) throw new Error('addListener callback was not captured');
-    capturedListener(MEASUREMENT);
-
-    expect(capturedResult?.()).toEqual(MEASUREMENT);
-  });
-
-  it('removes the subscription when the host component is unmounted', async () => {
-    mount(ROOT_TAG, AccelerometerHost);
-    await tick();
-
-    unmount(ROOT_TAG);
-    await tick();
-
-    expect(removeMock).toHaveBeenCalledOnce();
-  });
-
-  it('calls setUpdateInterval with the given interval when one is passed', async () => {
-    mount(ROOT_TAG, AccelerometerIntervalHost);
-    await tick();
-
-    expect(setUpdateIntervalMock).toHaveBeenCalledWith(500);
-  });
-
-  it('does not call setUpdateInterval when no interval is passed', async () => {
-    mount(ROOT_TAG, AccelerometerHost);
-    await tick();
-
-    expect(setUpdateIntervalMock).not.toHaveBeenCalled();
-  });
-});

package/src/angular/services/barometer.service/barometer.service.test.ts

@@ -1,122 +0,0 @@
-// Co-located Angular-driven test (ADR 0025) for BarometerService. Mounts a real host
-// component through @symbiote-native/angular so `connect()` runs the same way an app would call
-// it — inside the component's own injection context — and drives the returned signal through a
-// full mount/unmount lifecycle, because `effect()`'s injector-scoped cleanup only fires
-// correctly when torn down through a real Angular injection context.
-
-import '@angular/compiler';
-import { Component, inject, type Signal } from '@angular/core';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { mount, unmount } from '@symbiote-native/angular';
-import { installFabric } from '@symbiote-native/test-utils';
-import type { IBarometerMeasurement } from '../../../core';
-import { BarometerService } from './index';
-
-const addListenerMock = vi.fn();
-const removeMock = vi.fn();
-const setUpdateIntervalMock = vi.fn();
-
-vi.mock('../../../core', () => ({
-  Barometer: {
-    addListener: (listener: (measurement: IBarometerMeasurement) => void) =>
-      addListenerMock(listener),
-    setUpdateInterval: (intervalMs: number) => setUpdateIntervalMock(intervalMs),
-  },
-}));
-
-const ROOT_TAG = 942;
-const fabric = installFabric();
-const tick = (): Promise<void> => new Promise(resolve => setTimeout(resolve, 0));
-
-const MEASUREMENT: IBarometerMeasurement = {
-  pressure: 1013.25,
-  relativeAltitude: 12.3,
-  timestamp: 123,
-};
-
-let capturedResult: Signal<IBarometerMeasurement | null> | undefined;
-let capturedListener: ((measurement: IBarometerMeasurement) => void) | undefined;
-
-@Component({
-  selector: 'symbiote-barometer-host',
-  standalone: true,
-  template: '',
-})
-class BarometerHost {
-  readonly measurement = inject(BarometerService).connect();
-
-  constructor() {
-    capturedResult = this.measurement;
-  }
-}
-
-@Component({
-  selector: 'symbiote-barometer-interval-host',
-  standalone: true,
-  template: '',
-})
-class BarometerIntervalHost {
-  readonly measurement = inject(BarometerService).connect(500);
-
-  constructor() {
-    capturedResult = this.measurement;
-  }
-}
-
-beforeEach(() => {
-  capturedResult = undefined;
-  capturedListener = undefined;
-  addListenerMock.mockImplementation(listener => {
-    capturedListener = listener;
-    return { remove: removeMock };
-  });
-});
-
-afterEach(() => {
-  unmount(ROOT_TAG);
-  fabric.reset();
-  vi.clearAllMocks();
-});
-
-describe('BarometerService.connect', () => {
-  it('reports null before any measurement event fires', async () => {
-    mount(ROOT_TAG, BarometerHost);
-    await tick();
-
-    expect(capturedResult?.()).toBeNull();
-  });
-
-  it('updates the signal when the registered listener fires with a measurement', async () => {
-    mount(ROOT_TAG, BarometerHost);
-    await tick();
-
-    if (capturedListener === undefined) throw new Error('addListener callback was not captured');
-    capturedListener(MEASUREMENT);
-
-    expect(capturedResult?.()).toEqual(MEASUREMENT);
-  });
-
-  it('removes the subscription when the host component is unmounted', async () => {
-    mount(ROOT_TAG, BarometerHost);
-    await tick();
-
-    unmount(ROOT_TAG);
-    await tick();
-
-    expect(removeMock).toHaveBeenCalledOnce();
-  });
-
-  it('calls setUpdateInterval with the given interval when one is passed', async () => {
-    mount(ROOT_TAG, BarometerIntervalHost);
-    await tick();
-
-    expect(setUpdateIntervalMock).toHaveBeenCalledWith(500);
-  });
-
-  it('does not call setUpdateInterval when no interval is passed', async () => {
-    mount(ROOT_TAG, BarometerHost);
-    await tick();
-
-    expect(setUpdateIntervalMock).not.toHaveBeenCalled();
-  });
-});

package/src/angular/services/device-motion.service/device-motion.service.test.ts

@@ -1,125 +0,0 @@
-// Co-located Angular-driven test (ADR 0025) for DeviceMotionService. Mounts a real host
-// component through @symbiote-native/angular so `connect()` runs the same way an app would call
-// it — inside the component's own injection context — and drives the returned signal through a
-// full mount/unmount lifecycle, because `effect()`'s injector-scoped cleanup only fires
-// correctly when torn down through a real Angular injection context.
-
-import '@angular/compiler';
-import { Component, inject, type Signal } from '@angular/core';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { mount, unmount } from '@symbiote-native/angular';
-import { installFabric } from '@symbiote-native/test-utils';
-import type { IDeviceMotionMeasurement } from '../../../core';
-import { DeviceMotionService } from './index';
-
-const addListenerMock = vi.fn();
-const removeMock = vi.fn();
-const setUpdateIntervalMock = vi.fn();
-
-vi.mock('../../../core', () => ({
-  DeviceMotion: {
-    addListener: (listener: (measurement: IDeviceMotionMeasurement) => void) =>
-      addListenerMock(listener),
-    setUpdateInterval: (intervalMs: number) => setUpdateIntervalMock(intervalMs),
-  },
-}));
-
-const ROOT_TAG = 942;
-const fabric = installFabric();
-const tick = (): Promise<void> => new Promise(resolve => setTimeout(resolve, 0));
-
-const MEASUREMENT: IDeviceMotionMeasurement = {
-  acceleration: { x: 0.1, y: 0.2, z: 0.3, timestamp: 123 },
-  accelerationIncludingGravity: { x: 0.1, y: 0.2, z: 9.8, timestamp: 123 },
-  rotation: { alpha: 1, beta: 2, gamma: 3, timestamp: 123 },
-  rotationRate: { alpha: 0.1, beta: 0.2, gamma: 0.3, timestamp: 123 },
-  interval: 16,
-  orientation: 0, // DeviceMotionOrientation.Portrait
-};
-
-let capturedResult: Signal<IDeviceMotionMeasurement | null> | undefined;
-let capturedListener: ((measurement: IDeviceMotionMeasurement) => void) | undefined;
-
-@Component({
-  selector: 'symbiote-device-motion-host',
-  standalone: true,
-  template: '',
-})
-class DeviceMotionHost {
-  readonly measurement = inject(DeviceMotionService).connect();
-
-  constructor() {
-    capturedResult = this.measurement;
-  }
-}
-
-@Component({
-  selector: 'symbiote-device-motion-interval-host',
-  standalone: true,
-  template: '',
-})
-class DeviceMotionIntervalHost {
-  readonly measurement = inject(DeviceMotionService).connect(500);
-
-  constructor() {
-    capturedResult = this.measurement;
-  }
-}
-
-beforeEach(() => {
-  capturedResult = undefined;
-  capturedListener = undefined;
-  addListenerMock.mockImplementation(listener => {
-    capturedListener = listener;
-    return { remove: removeMock };
-  });
-});
-
-afterEach(() => {
-  unmount(ROOT_TAG);
-  fabric.reset();
-  vi.clearAllMocks();
-});
-
-describe('DeviceMotionService.connect', () => {
-  it('reports null before any measurement event fires', async () => {
-    mount(ROOT_TAG, DeviceMotionHost);
-    await tick();
-
-    expect(capturedResult?.()).toBeNull();
-  });
-
-  it('updates the signal when the registered listener fires with a measurement', async () => {
-    mount(ROOT_TAG, DeviceMotionHost);
-    await tick();
-
-    if (capturedListener === undefined) throw new Error('addListener callback was not captured');
-    capturedListener(MEASUREMENT);
-
-    expect(capturedResult?.()).toEqual(MEASUREMENT);
-  });
-
-  it('removes the subscription when the host component is unmounted', async () => {
-    mount(ROOT_TAG, DeviceMotionHost);
-    await tick();
-
-    unmount(ROOT_TAG);
-    await tick();
-
-    expect(removeMock).toHaveBeenCalledOnce();
-  });
-
-  it('calls setUpdateInterval with the given interval when one is passed', async () => {
-    mount(ROOT_TAG, DeviceMotionIntervalHost);
-    await tick();
-
-    expect(setUpdateIntervalMock).toHaveBeenCalledWith(500);
-  });
-
-  it('does not call setUpdateInterval when no interval is passed', async () => {
-    mount(ROOT_TAG, DeviceMotionHost);
-    await tick();
-
-    expect(setUpdateIntervalMock).not.toHaveBeenCalled();
-  });
-});

package/src/angular/services/gyroscope.service/gyroscope.service.test.ts

@@ -1,118 +0,0 @@
-// Co-located Angular-driven test (ADR 0025) for GyroscopeService. Mounts a real host
-// component through @symbiote-native/angular so `connect()` runs the same way an app would call
-// it — inside the component's own injection context — and drives the returned signal through a
-// full mount/unmount lifecycle, because `effect()`'s injector-scoped cleanup only fires
-// correctly when torn down through a real Angular injection context.
-
-import '@angular/compiler';
-import { Component, inject, type Signal } from '@angular/core';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { mount, unmount } from '@symbiote-native/angular';
-import { installFabric } from '@symbiote-native/test-utils';
-import type { IGyroscopeMeasurement } from '../../../core';
-import { GyroscopeService } from './index';
-
-const addListenerMock = vi.fn();
-const removeMock = vi.fn();
-const setUpdateIntervalMock = vi.fn();
-
-vi.mock('../../../core', () => ({
-  Gyroscope: {
-    addListener: (listener: (measurement: IGyroscopeMeasurement) => void) =>
-      addListenerMock(listener),
-    setUpdateInterval: (intervalMs: number) => setUpdateIntervalMock(intervalMs),
-  },
-}));
-
-const ROOT_TAG = 942;
-const fabric = installFabric();
-const tick = (): Promise<void> => new Promise(resolve => setTimeout(resolve, 0));
-
-const MEASUREMENT: IGyroscopeMeasurement = { x: 0.1, y: 0.2, z: 0.3, timestamp: 123 };
-
-let capturedResult: Signal<IGyroscopeMeasurement | null> | undefined;
-let capturedListener: ((measurement: IGyroscopeMeasurement) => void) | undefined;
-
-@Component({
-  selector: 'symbiote-gyroscope-host',
-  standalone: true,
-  template: '',
-})
-class GyroscopeHost {
-  readonly measurement = inject(GyroscopeService).connect();
-
-  constructor() {
-    capturedResult = this.measurement;
-  }
-}
-
-@Component({
-  selector: 'symbiote-gyroscope-interval-host',
-  standalone: true,
-  template: '',
-})
-class GyroscopeIntervalHost {
-  readonly measurement = inject(GyroscopeService).connect(500);
-
-  constructor() {
-    capturedResult = this.measurement;
-  }
-}
-
-beforeEach(() => {
-  capturedResult = undefined;
-  capturedListener = undefined;
-  addListenerMock.mockImplementation(listener => {
-    capturedListener = listener;
-    return { remove: removeMock };
-  });
-});
-
-afterEach(() => {
-  unmount(ROOT_TAG);
-  fabric.reset();
-  vi.clearAllMocks();
-});
-
-describe('GyroscopeService.connect', () => {
-  it('reports null before any measurement event fires', async () => {
-    mount(ROOT_TAG, GyroscopeHost);
-    await tick();
-
-    expect(capturedResult?.()).toBeNull();
-  });
-
-  it('updates the signal when the registered listener fires with a measurement', async () => {
-    mount(ROOT_TAG, GyroscopeHost);
-    await tick();
-
-    if (capturedListener === undefined) throw new Error('addListener callback was not captured');
-    capturedListener(MEASUREMENT);
-
-    expect(capturedResult?.()).toEqual(MEASUREMENT);
-  });
-
-  it('removes the subscription when the host component is unmounted', async () => {
-    mount(ROOT_TAG, GyroscopeHost);
-    await tick();
-
-    unmount(ROOT_TAG);
-    await tick();
-
-    expect(removeMock).toHaveBeenCalledOnce();
-  });
-
-  it('calls setUpdateInterval with the given interval when one is passed', async () => {
-    mount(ROOT_TAG, GyroscopeIntervalHost);
-    await tick();
-
-    expect(setUpdateIntervalMock).toHaveBeenCalledWith(500);
-  });
-
-  it('does not call setUpdateInterval when no interval is passed', async () => {
-    mount(ROOT_TAG, GyroscopeHost);
-    await tick();
-
-    expect(setUpdateIntervalMock).not.toHaveBeenCalled();
-  });
-});