@symbiote-native/sensors 0.2.0 → 0.3.0

package/src/svelte/runes/use-magnetometer.svelte.ts

@@ -0,0 +1,27 @@
+// Svelte lifecycle wiring over the framework-agnostic Magnetometer singleton (core/) — mirrors
+// use-accelerometer.svelte.ts's shape exactly. See its header for why this lives in `runes/` with
+// a `.svelte.ts` extension, returns a boxed getter object, and takes a plain `updateIntervalMs`
+// rather than a getter.
+import { Magnetometer, type EventSubscription, type IMagnetometerMeasurement } from '../../core';
+
+export function useMagnetometer(updateIntervalMs?: number): {
+  readonly current: IMagnetometerMeasurement | null;
+} {
+  let measurement = $state<IMagnetometerMeasurement | null>(null);
+
+  $effect(() => {
+    if (updateIntervalMs !== undefined) {
+      Magnetometer.setUpdateInterval(updateIntervalMs);
+    }
+    const subscription: EventSubscription = Magnetometer.addListener(next => {
+      measurement = next;
+    });
+    return () => subscription.remove();
+  });
+
+  return {
+    get current(): IMagnetometerMeasurement | null {
+      return measurement;
+    },
+  };
+}

package/src/svelte/runes/use-pedometer.svelte.ts

@@ -0,0 +1,23 @@
+// Svelte lifecycle wiring over the framework-agnostic watchStepCount free function (core/) —
+// mirrors use-accelerometer.svelte.ts's shape. Pedometer has no setUpdateInterval, so unlike
+// useAccelerometer there is no interval param to apply at subscribe time. See
+// use-accelerometer.svelte.ts's header for why this lives in `runes/` with a `.svelte.ts`
+// extension and returns a boxed getter object.
+import { watchStepCount, type EventSubscription, type IPedometerResult } from '../../core';
+
+export function usePedometer(): { readonly current: IPedometerResult | null } {
+  let result = $state<IPedometerResult | null>(null);
+
+  $effect(() => {
+    const subscription: EventSubscription = watchStepCount(next => {
+      result = next;
+    });
+    return () => subscription.remove();
+  });
+
+  return {
+    get current(): IPedometerResult | null {
+      return result;
+    },
+  };
+}

package/src/svelte/svelte-ambient.d.ts

@@ -0,0 +1,6 @@
+// Pulls in svelte's ambient global declarations ($state/$effect/...) for this package's tsc
+// program. adapters/svelte gets these for free because render.ts does a real value import from
+// 'svelte' (any file in a program importing a module loads its ambient globals for the whole
+// program); this package has no such import, so a triple-slash reference does the same job
+// explicitly rather than relying on an incidental side-effect.
+/// <reference types="svelte" />

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();
-  });
-});

package/src/angular/services/light-sensor.service/light-sensor.service.test.ts

@@ -1,118 +0,0 @@
-// Co-located Angular-driven test (ADR 0025) for LightSensorService. 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 { ILightSensorMeasurement } from '../../../core';
-import { LightSensorService } from './index';
-
-const addListenerMock = vi.fn();
-const removeMock = vi.fn();
-const setUpdateIntervalMock = vi.fn();
-
-vi.mock('../../../core', () => ({
-  LightSensor: {
-    addListener: (listener: (measurement: ILightSensorMeasurement) => 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: ILightSensorMeasurement = { illuminance: 42, timestamp: 123 };
-
-let capturedResult: Signal<ILightSensorMeasurement | null> | undefined;
-let capturedListener: ((measurement: ILightSensorMeasurement) => void) | undefined;
-
-@Component({
-  selector: 'symbiote-light-sensor-host',
-  standalone: true,
-  template: '',
-})
-class LightSensorHost {
-  readonly measurement = inject(LightSensorService).connect();
-
-  constructor() {
-    capturedResult = this.measurement;
-  }
-}
-
-@Component({
-  selector: 'symbiote-light-sensor-interval-host',
-  standalone: true,
-  template: '',
-})
-class LightSensorIntervalHost {
-  readonly measurement = inject(LightSensorService).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('LightSensorService.connect', () => {
-  it('reports null before any measurement event fires', async () => {
-    mount(ROOT_TAG, LightSensorHost);
-    await tick();
-
-    expect(capturedResult?.()).toBeNull();
-  });
-
-  it('updates the signal when the registered listener fires with a measurement', async () => {
-    mount(ROOT_TAG, LightSensorHost);
-    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, LightSensorHost);
-    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, LightSensorIntervalHost);
-    await tick();
-
-    expect(setUpdateIntervalMock).toHaveBeenCalledWith(500);
-  });
-
-  it('does not call setUpdateInterval when no interval is passed', async () => {
-    mount(ROOT_TAG, LightSensorHost);
-    await tick();
-
-    expect(setUpdateIntervalMock).not.toHaveBeenCalled();
-  });
-});