@therealitycrafters/react-native-evskit 0.0.0-stage → 0.1.1

package/build/EvsKit.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvsKit.types.js","sourceRoot":"","sources":["../src/EvsKit.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG","sourcesContent":["/**\n * Type definitions mirroring Everysight's Maverick SDK interfaces\n * (IEvsCommunicationService, IEvsGlassesStateService, IEvsDisplayService,\n * IEvsSensorsService, IEvsAuthService).\n *\n * Signatures confirmed against the everysight-maverick/samples repo (v2.6.1)\n * and the MCP API reference.\n */\n\n// ---------------------------------------------------------------------------\n// Communication (IEvsCommunicationService)\n// ---------------------------------------------------------------------------\n\nexport interface EvsDeviceInfo {\n  /** Bluetooth device address/id, e.g. from a BLE scan (EV0080 style name). */\n  deviceId: string;\n  /** Bluetooth device name. */\n  name: string;\n}\n\nexport type EvsConnectionState =\n  \"disconnected\" | \"connecting\" | \"connected\" | \"authenticating\" | \"error\";\n\n// ---------------------------------------------------------------------------\n// Glasses (IEvsGlassesStateService)\n// ---------------------------------------------------------------------------\n\nexport interface EvsGlassesInfo {\n  /** Battery percentage 0-100 from IEvsGlassesStateService.batteryPercentage(). */\n  batteryLevel: number;\n  /** Battery level category (Unknown/Critical/Low/Medium/High) from batteryLevel(). */\n  batteryStatus: string;\n  /** Estimated remaining operation time in minutes. */\n  estimatedRemainingTime: number;\n  /** Firmware version number (Int from fwVersion()). */\n  firmwareVersion: number;\n}\n\nexport type TouchDirection = \"backward\" | \"forward\" | \"tap\" | \"longTap\";\n\nexport type ProximityEvent = \"onFace\" | \"offFace\";\n\n// ---------------------------------------------------------------------------\n// Display (IEvsDisplayService)\n// ---------------------------------------------------------------------------\n\nexport interface EvsAutoBrightnessOptions {\n  enabled: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Sensors (IEvsSensorsService)\n// ---------------------------------------------------------------------------\n\nexport type CalibrationStatus = \"calibrated\" | \"inProgress\" | \"required\";\n\n/** Currently only rate0 and rate1 are operational per the SDK docs; the rest are experimental. */\nexport type SensorRate = \"rate0\" | \"rate1\" | \"rate2\" | \"rate3\";\n\nexport interface EvsYprData {\n  yaw: number;\n  pitch: number;\n  roll: number;\n}\n\nexport interface EvsQuaternionData {\n  w: number;\n  x: number;\n  y: number;\n  z: number;\n}\n\nexport interface EvsVector3 {\n  x: number;\n  y: number;\n  z: number;\n}\n\nexport interface EvsSensorSample<T> {\n  timestampMs: number;\n  data: T;\n}\n\nexport interface EvsYprSample extends EvsSensorSample<EvsYprData> {\n  calibrationStatus: CalibrationStatus;\n}\n\nexport interface EvsQuaternionSample extends EvsSensorSample<EvsQuaternionData> {\n  calibrationStatus: CalibrationStatus;\n}\n\n// ---------------------------------------------------------------------------\n// Stock UI (Evs.instance().showUI(...))\n// ---------------------------------------------------------------------------\n\nexport type EvsStockUIScreen = \"configure\" | \"adjust\" | \"calibrate\";\n\n// ---------------------------------------------------------------------------\n// Auth (IEvsAuthService) / lifecycle events (IEvsAppEvents)\n// ---------------------------------------------------------------------------\n\nexport interface EvsBeginAuthEvent {\n  serial: string;\n  fwVersion: number;\n}\n\n// ---------------------------------------------------------------------------\n// Native event map — every event the native module can emit to JS via\n// EventEmitter. Keep this in sync with EvsKitModule.kt / EvsKitModule.swift.\n// ---------------------------------------------------------------------------\n\nexport type EvsKitEvents = {\n  onConnectionStateChanged: (state: EvsConnectionState) => void;\n  onBeginAuth: (event: EvsBeginAuthEvent) => void;\n  onGlassesInfoChanged: (info: EvsGlassesInfo) => void;\n  onTouch: (direction: TouchDirection) => void;\n  onProximity: (event: ProximityEvent) => void;\n  onAmbient: (lux: number) => void;\n  onYpr: (sample: EvsYprSample) => void;\n  onQuaternion: (sample: EvsQuaternionSample) => void;\n  onError: (message: string) => void;\n};\n"]}

package/build/EvsKitModule.d.ts

@@ -0,0 +1,43 @@
+import { NativeModule } from "expo-modules-core";
+import type { EvsAutoBrightnessOptions, EvsDeviceInfo, EvsGlassesInfo, EvsKitEvents, EvsStockUIScreen } from "./EvsKit.types";
+/**
+ * Raw native surface. This intentionally mirrors the SDK's service methods
+ * 1:1 (comm/glasses/display/sensors/auth) rather than inventing a different
+ * shape, so the JS API stays easy to cross-reference against the Maverick
+ * docs. Prefer using the higher-level classes exported from `src/index.ts`
+ * over calling this module directly.
+ */
+declare class EvsKitNativeModule extends NativeModule<EvsKitEvents> {
+    /** Evs.init(context).start() on Android / Evs.instance().start() on iOS. */
+    start(): Promise<void>;
+    isStarted(): Promise<boolean>;
+    /** Evs.instance().showUI(name) — "configure" | "adjust" | "calibrate". */
+    showUI(screen: EvsStockUIScreen): Promise<void>;
+    setDeviceInfo(info: EvsDeviceInfo): Promise<void>;
+    connect(): Promise<void>;
+    connectSecured(): Promise<void>;
+    disconnect(): Promise<void>;
+    hasConfiguredDevice(): Promise<boolean>;
+    getGlassesInfo(): Promise<EvsGlassesInfo>;
+    turnGlassesOff(): Promise<void>;
+    turnDisplayOn(): Promise<void>;
+    /** Continuous brightness, 1-255. */
+    setBrightness(value: number): Promise<void>;
+    /** Discrete, display-optimized brightness controller. */
+    setBrightnessLevel(level: number): Promise<void>;
+    setAutoBrightness(options: EvsAutoBrightnessOptions): Promise<void>;
+    setRenderingCenterX(dx: number): Promise<void>;
+    setRenderingCenterY(dy: number): Promise<void>;
+    enableTouch(enabled: boolean): Promise<void>;
+    enableAmbient(enabled: boolean): Promise<void>;
+    enableGyro(enabled: boolean): Promise<void>;
+    enableMagnetometer(enabled: boolean): Promise<void>;
+    enableAccelerometer(enabled: boolean): Promise<void>;
+    enableSensorsFusion(enabled: boolean): Promise<void>;
+    setApiKeyName(fileNameWithoutExt: string): Promise<void>;
+    /** base64-encoded key bytes. */
+    setApiKey(base64Key: string): Promise<void>;
+}
+declare const _default: EvsKitNativeModule;
+export default _default;
+//# sourceMappingURL=EvsKitModule.d.ts.map

package/build/EvsKitModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvsKitModule.d.ts","sourceRoot":"","sources":["../src/EvsKitModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,mBAAmB,CAAC;AAEtE,OAAO,KAAK,EACV,wBAAwB,EACxB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAExB;;;;;;GAMG;AACH,OAAO,OAAO,kBAAmB,SAAQ,YAAY,CAAC,YAAY,CAAC;IAEjE,4EAA4E;IAC5E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IACtB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAG7B,0EAA0E;IAC1E,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAG/C,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IACjD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IACxB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAC/B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAC3B,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC;IAGvC,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC;IACzC,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAG/B,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAC9B,oCAAoC;IACpC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3C,yDAAyD;IACzD,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAChD,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAGnE,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9C,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAG9C,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAC5C,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9C,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3C,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IACnD,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IACpD,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAGpD,aAAa,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACxD,gCAAgC;IAChC,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAC5C;;AAED,wBAAmE"}

package/build/EvsKitModule.js

@@ -0,0 +1,3 @@
+import { requireNativeModule } from "expo-modules-core";
+export default requireNativeModule("RNEvsKit");
+//# sourceMappingURL=EvsKitModule.js.map

package/build/EvsKitModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvsKitModule.js","sourceRoot":"","sources":["../src/EvsKitModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAgEtE,eAAe,mBAAmB,CAAqB,UAAU,CAAC,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from \"expo-modules-core\";\n\nimport type {\n  EvsAutoBrightnessOptions,\n  EvsDeviceInfo,\n  EvsGlassesInfo,\n  EvsKitEvents,\n  EvsStockUIScreen,\n} from \"./EvsKit.types\";\n\n/**\n * Raw native surface. This intentionally mirrors the SDK's service methods\n * 1:1 (comm/glasses/display/sensors/auth) rather than inventing a different\n * shape, so the JS API stays easy to cross-reference against the Maverick\n * docs. Prefer using the higher-level classes exported from `src/index.ts`\n * over calling this module directly.\n */\ndeclare class EvsKitNativeModule extends NativeModule<EvsKitEvents> {\n  // --- Lifecycle -----------------------------------------------------------\n  /** Evs.init(context).start() on Android / Evs.instance().start() on iOS. */\n  start(): Promise<void>;\n  isStarted(): Promise<boolean>;\n\n  // --- Stock UI --------------------------------------------------------------\n  /** Evs.instance().showUI(name) — \"configure\" | \"adjust\" | \"calibrate\". */\n  showUI(screen: EvsStockUIScreen): Promise<void>;\n\n  // --- Communication (IEvsCommunicationService) -----------------------------\n  setDeviceInfo(info: EvsDeviceInfo): Promise<void>;\n  connect(): Promise<void>;\n  connectSecured(): Promise<void>;\n  disconnect(): Promise<void>;\n  hasConfiguredDevice(): Promise<boolean>;\n\n  // --- Glasses (IEvsGlassesStateService) -------------------------------------\n  getGlassesInfo(): Promise<EvsGlassesInfo>;\n  turnGlassesOff(): Promise<void>;\n\n  // --- Display (IEvsDisplayService) ------------------------------------------\n  turnDisplayOn(): Promise<void>;\n  /** Continuous brightness, 1-255. */\n  setBrightness(value: number): Promise<void>;\n  /** Discrete, display-optimized brightness controller. */\n  setBrightnessLevel(level: number): Promise<void>;\n  setAutoBrightness(options: EvsAutoBrightnessOptions): Promise<void>;\n\n  // --- Screens (rendering offset) ---------------------------------------------\n  setRenderingCenterX(dx: number): Promise<void>;\n  setRenderingCenterY(dy: number): Promise<void>;\n\n  // --- Sensors (IEvsSensorsService) -------------------------------------------\n  enableTouch(enabled: boolean): Promise<void>;\n  enableAmbient(enabled: boolean): Promise<void>;\n  enableGyro(enabled: boolean): Promise<void>;\n  enableMagnetometer(enabled: boolean): Promise<void>;\n  enableAccelerometer(enabled: boolean): Promise<void>;\n  enableSensorsFusion(enabled: boolean): Promise<void>;\n\n  // --- Auth (IEvsAuthService) --------------------------------------------------\n  setApiKeyName(fileNameWithoutExt: string): Promise<void>;\n  /** base64-encoded key bytes. */\n  setApiKey(base64Key: string): Promise<void>;\n}\n\nexport default requireNativeModule<EvsKitNativeModule>(\"RNEvsKit\");\n"]}

package/build/index.d.ts

@@ -0,0 +1,118 @@
+import type { EventSubscription } from "expo-modules-core";
+import type { EvsAutoBrightnessOptions, EvsDeviceInfo, EvsGlassesInfo, EvsKitEvents, EvsStockUIScreen } from "./EvsKit.types";
+export * from "./EvsKit.types";
+/**
+ * Communication service — mirrors IEvsCommunicationService
+ * (`Evs.instance().comm()`).
+ *
+ * Scanning for glasses is NOT handled here: the SDK docs specify scanning
+ * is done with the platform's standard BLE APIs (CBCentralManager /
+ * BluetoothLeScanner) against `BTConstants.serviceUUID`, filtering for the
+ * "EV####" name pattern. Pair that with a BLE library (e.g. react-native-ble-plx)
+ * or just use `EvsUI.show('configure')` for the SDK's built-in scan/pair flow.
+ */
+export declare const EvsComm: {
+    setDeviceInfo(info: EvsDeviceInfo): Promise<void>;
+    connect(): Promise<void>;
+    /** Use instead of connect() when the app requires BLE pairing. */
+    connectSecured(): Promise<void>;
+    disconnect(): Promise<void>;
+    hasConfiguredDevice(): Promise<boolean>;
+};
+/** Mirrors IEvsGlassesStateService (`Evs.instance().glasses()`). */
+export declare const EvsGlasses: {
+    getInfo(): Promise<EvsGlassesInfo>;
+    turnOff(): Promise<void>;
+};
+/** Mirrors IEvsDisplayService (`Evs.instance().display()`) plus screen offset controls. */
+export declare const EvsDisplay: {
+    turnOn(): Promise<void>;
+    /** Continuous scale, 1-255. Prefer setBrightnessLevel() where possible. */
+    setBrightness(value: number): Promise<void>;
+    /** Discrete brightness level via the SDK's display-optimized controller. */
+    setBrightnessLevel(level: number): Promise<void>;
+    setAutoBrightness(options: EvsAutoBrightnessOptions): Promise<void>;
+    /** Adjust the virtual rendering area's center offset within the 640x400 display. */
+    setRenderingCenter(dx: number, dy: number): Promise<[void, void]>;
+};
+/**
+ * Mirrors IEvsSensorsService (`Evs.instance().sensors()`).
+ * Remember to disable sensors and unsubscribe events when no longer needed —
+ * the SDK docs call this out explicitly for battery/bandwidth reasons.
+ */
+export declare const EvsSensors: {
+    enableTouch(enabled: boolean): Promise<void>;
+    enableAmbient(enabled: boolean): Promise<void>;
+    enableGyro(enabled: boolean): Promise<void>;
+    enableMagnetometer(enabled: boolean): Promise<void>;
+    enableAccelerometer(enabled: boolean): Promise<void>;
+    /** Enables Gyro + Magnetometer + Accelerometer and starts the fusion algorithm. */
+    enableFusion(enabled: boolean): Promise<void>;
+};
+/** Mirrors IEvsAuthService (`Evs.instance().auth()`). Usually unnecessary — see API Keys docs. */
+export declare const EvsAuth: {
+    setApiKeyName(fileNameWithoutExt: string): Promise<void>;
+    setApiKey(base64Key: string): Promise<void>;
+};
+/** Mirrors `Evs.instance().showUI(...)` — the SDK's built-in portrait UI screens. */
+export declare const EvsUI: {
+    show(screen: EvsStockUIScreen): Promise<void>;
+};
+/** Top-level lifecycle, matching `Evs.init(context).start()` / `Evs.instance().start()`. */
+export declare const EvsKit: {
+    start(): Promise<void>;
+    isStarted(): Promise<boolean>;
+    comm: {
+        setDeviceInfo(info: EvsDeviceInfo): Promise<void>;
+        connect(): Promise<void>;
+        /** Use instead of connect() when the app requires BLE pairing. */
+        connectSecured(): Promise<void>;
+        disconnect(): Promise<void>;
+        hasConfiguredDevice(): Promise<boolean>;
+    };
+    glasses: {
+        getInfo(): Promise<EvsGlassesInfo>;
+        turnOff(): Promise<void>;
+    };
+    display: {
+        turnOn(): Promise<void>;
+        /** Continuous scale, 1-255. Prefer setBrightnessLevel() where possible. */
+        setBrightness(value: number): Promise<void>;
+        /** Discrete brightness level via the SDK's display-optimized controller. */
+        setBrightnessLevel(level: number): Promise<void>;
+        setAutoBrightness(options: EvsAutoBrightnessOptions): Promise<void>;
+        /** Adjust the virtual rendering area's center offset within the 640x400 display. */
+        setRenderingCenter(dx: number, dy: number): Promise<[void, void]>;
+    };
+    sensors: {
+        enableTouch(enabled: boolean): Promise<void>;
+        enableAmbient(enabled: boolean): Promise<void>;
+        enableGyro(enabled: boolean): Promise<void>;
+        enableMagnetometer(enabled: boolean): Promise<void>;
+        enableAccelerometer(enabled: boolean): Promise<void>;
+        /** Enables Gyro + Magnetometer + Accelerometer and starts the fusion algorithm. */
+        enableFusion(enabled: boolean): Promise<void>;
+    };
+    auth: {
+        setApiKeyName(fileNameWithoutExt: string): Promise<void>;
+        setApiKey(base64Key: string): Promise<void>;
+    };
+    ui: {
+        show(screen: EvsStockUIScreen): Promise<void>;
+    };
+};
+export default EvsKit;
+/** Subscribe to a single EvsKit event; call the returned function to unsubscribe. */
+export declare function addEvsKitListener<K extends keyof EvsKitEvents>(eventName: K, listener: EvsKitEvents[K]): EventSubscription;
+/**
+ * React hook that subscribes to an EvsKit event for the lifetime of the
+ * component. Pass a stable callback (e.g. via useCallback) to avoid
+ * resubscribing every render.
+ *
+ * @example
+ * useEvsKitEvent('onTouch', (direction) => {
+ *   if (direction === 'tap') showPopup();
+ * });
+ */
+export declare function useEvsKitEvent<K extends keyof EvsKitEvents>(eventName: K, listener: EvsKitEvents[K]): void;
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,OAAO,KAAK,EACV,wBAAwB,EACxB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAGxB,cAAc,gBAAgB,CAAC;AAE/B;;;;;;;;;GASG;AACH,eAAO,MAAM,OAAO;wBACE,aAAa;;IAMjC,kEAAkE;;;;CAUnE,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,UAAU;eACV,OAAO,CAAC,cAAc,CAAC;;CAMnC,CAAC;AAEF,2FAA2F;AAC3F,eAAO,MAAM,UAAU;;IAIrB,2EAA2E;yBACtD,MAAM;IAG3B,4EAA4E;8BAClD,MAAM;+BAGL,wBAAwB;IAGnD,oFAAoF;2BAC7D,MAAM,MAAM,MAAM;CAM1C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU;yBACA,OAAO;2BAGL,OAAO;wBAGV,OAAO;gCAGC,OAAO;iCAGN,OAAO;IAGpC,mFAAmF;0BAC7D,OAAO;CAG9B,CAAC;AAEF,kGAAkG;AAClG,eAAO,MAAM,OAAO;sCACgB,MAAM;yBAGnB,MAAM;CAG5B,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,KAAK;iBACH,gBAAgB;CAG9B,CAAC;AAEF,4FAA4F;AAC5F,eAAO,MAAM,MAAM;;;;4BAlGG,aAAa;;QAMjC,kEAAkE;;;;;;mBAcvD,OAAO,CAAC,cAAc,CAAC;;;;;QAalC,2EAA2E;6BACtD,MAAM;QAG3B,4EAA4E;kCAClD,MAAM;mCAGL,wBAAwB;QAGnD,oFAAoF;+BAC7D,MAAM,MAAM,MAAM;;;6BAcpB,OAAO;+BAGL,OAAO;4BAGV,OAAO;oCAGC,OAAO;qCAGN,OAAO;QAGpC,mFAAmF;8BAC7D,OAAO;;;0CAOK,MAAM;6BAGnB,MAAM;;;qBAOd,gBAAgB;;CAmB9B,CAAC;AAEF,eAAe,MAAM,CAAC;AAMtB,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,YAAY,EAC5D,SAAS,EAAE,CAAC,EACZ,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GACxB,iBAAiB,CAEnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,YAAY,EACzD,SAAS,EAAE,CAAC,EACZ,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,QAO1B"}

package/build/index.js

@@ -0,0 +1,146 @@
+import { useEffect } from "react";
+import EvsKitNative from "./EvsKitModule";
+export * from "./EvsKit.types";
+/**
+ * Communication service — mirrors IEvsCommunicationService
+ * (`Evs.instance().comm()`).
+ *
+ * Scanning for glasses is NOT handled here: the SDK docs specify scanning
+ * is done with the platform's standard BLE APIs (CBCentralManager /
+ * BluetoothLeScanner) against `BTConstants.serviceUUID`, filtering for the
+ * "EV####" name pattern. Pair that with a BLE library (e.g. react-native-ble-plx)
+ * or just use `EvsUI.show('configure')` for the SDK's built-in scan/pair flow.
+ */
+export const EvsComm = {
+    setDeviceInfo(info) {
+        return EvsKitNative.setDeviceInfo(info);
+    },
+    connect() {
+        return EvsKitNative.connect();
+    },
+    /** Use instead of connect() when the app requires BLE pairing. */
+    connectSecured() {
+        return EvsKitNative.connectSecured();
+    },
+    disconnect() {
+        return EvsKitNative.disconnect();
+    },
+    hasConfiguredDevice() {
+        return EvsKitNative.hasConfiguredDevice();
+    },
+};
+/** Mirrors IEvsGlassesStateService (`Evs.instance().glasses()`). */
+export const EvsGlasses = {
+    getInfo() {
+        return EvsKitNative.getGlassesInfo();
+    },
+    turnOff() {
+        return EvsKitNative.turnGlassesOff();
+    },
+};
+/** Mirrors IEvsDisplayService (`Evs.instance().display()`) plus screen offset controls. */
+export const EvsDisplay = {
+    turnOn() {
+        return EvsKitNative.turnDisplayOn();
+    },
+    /** Continuous scale, 1-255. Prefer setBrightnessLevel() where possible. */
+    setBrightness(value) {
+        return EvsKitNative.setBrightness(value);
+    },
+    /** Discrete brightness level via the SDK's display-optimized controller. */
+    setBrightnessLevel(level) {
+        return EvsKitNative.setBrightnessLevel(level);
+    },
+    setAutoBrightness(options) {
+        return EvsKitNative.setAutoBrightness(options);
+    },
+    /** Adjust the virtual rendering area's center offset within the 640x400 display. */
+    setRenderingCenter(dx, dy) {
+        return Promise.all([
+            EvsKitNative.setRenderingCenterX(dx),
+            EvsKitNative.setRenderingCenterY(dy),
+        ]);
+    },
+};
+/**
+ * Mirrors IEvsSensorsService (`Evs.instance().sensors()`).
+ * Remember to disable sensors and unsubscribe events when no longer needed —
+ * the SDK docs call this out explicitly for battery/bandwidth reasons.
+ */
+export const EvsSensors = {
+    enableTouch(enabled) {
+        return EvsKitNative.enableTouch(enabled);
+    },
+    enableAmbient(enabled) {
+        return EvsKitNative.enableAmbient(enabled);
+    },
+    enableGyro(enabled) {
+        return EvsKitNative.enableGyro(enabled);
+    },
+    enableMagnetometer(enabled) {
+        return EvsKitNative.enableMagnetometer(enabled);
+    },
+    enableAccelerometer(enabled) {
+        return EvsKitNative.enableAccelerometer(enabled);
+    },
+    /** Enables Gyro + Magnetometer + Accelerometer and starts the fusion algorithm. */
+    enableFusion(enabled) {
+        return EvsKitNative.enableSensorsFusion(enabled);
+    },
+};
+/** Mirrors IEvsAuthService (`Evs.instance().auth()`). Usually unnecessary — see API Keys docs. */
+export const EvsAuth = {
+    setApiKeyName(fileNameWithoutExt) {
+        return EvsKitNative.setApiKeyName(fileNameWithoutExt);
+    },
+    setApiKey(base64Key) {
+        return EvsKitNative.setApiKey(base64Key);
+    },
+};
+/** Mirrors `Evs.instance().showUI(...)` — the SDK's built-in portrait UI screens. */
+export const EvsUI = {
+    show(screen) {
+        return EvsKitNative.showUI(screen);
+    },
+};
+/** Top-level lifecycle, matching `Evs.init(context).start()` / `Evs.instance().start()`. */
+export const EvsKit = {
+    start() {
+        return EvsKitNative.start();
+    },
+    isStarted() {
+        return EvsKitNative.isStarted();
+    },
+    comm: EvsComm,
+    glasses: EvsGlasses,
+    display: EvsDisplay,
+    sensors: EvsSensors,
+    auth: EvsAuth,
+    ui: EvsUI,
+};
+export default EvsKit;
+// ---------------------------------------------------------------------------
+// Event subscription helpers
+// ---------------------------------------------------------------------------
+/** Subscribe to a single EvsKit event; call the returned function to unsubscribe. */
+export function addEvsKitListener(eventName, listener) {
+    return EvsKitNative.addListener(eventName, listener);
+}
+/**
+ * React hook that subscribes to an EvsKit event for the lifetime of the
+ * component. Pass a stable callback (e.g. via useCallback) to avoid
+ * resubscribing every render.
+ *
+ * @example
+ * useEvsKitEvent('onTouch', (direction) => {
+ *   if (direction === 'tap') showPopup();
+ * });
+ */
+export function useEvsKitEvent(eventName, listener) {
+    useEffect(() => {
+        const subscription = addEvsKitListener(eventName, listener);
+        return () => subscription.remove();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [eventName, listener]);
+}
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { EventSubscription } from \"expo-modules-core\";\nimport { useEffect } from \"react\";\n\nimport type {\n  EvsAutoBrightnessOptions,\n  EvsDeviceInfo,\n  EvsGlassesInfo,\n  EvsKitEvents,\n  EvsStockUIScreen,\n} from \"./EvsKit.types\";\nimport EvsKitNative from \"./EvsKitModule\";\n\nexport * from \"./EvsKit.types\";\n\n/**\n * Communication service — mirrors IEvsCommunicationService\n * (`Evs.instance().comm()`).\n *\n * Scanning for glasses is NOT handled here: the SDK docs specify scanning\n * is done with the platform's standard BLE APIs (CBCentralManager /\n * BluetoothLeScanner) against `BTConstants.serviceUUID`, filtering for the\n * \"EV####\" name pattern. Pair that with a BLE library (e.g. react-native-ble-plx)\n * or just use `EvsUI.show('configure')` for the SDK's built-in scan/pair flow.\n */\nexport const EvsComm = {\n  setDeviceInfo(info: EvsDeviceInfo) {\n    return EvsKitNative.setDeviceInfo(info);\n  },\n  connect() {\n    return EvsKitNative.connect();\n  },\n  /** Use instead of connect() when the app requires BLE pairing. */\n  connectSecured() {\n    return EvsKitNative.connectSecured();\n  },\n  disconnect() {\n    return EvsKitNative.disconnect();\n  },\n  hasConfiguredDevice() {\n    return EvsKitNative.hasConfiguredDevice();\n  },\n};\n\n/** Mirrors IEvsGlassesStateService (`Evs.instance().glasses()`). */\nexport const EvsGlasses = {\n  getInfo(): Promise<EvsGlassesInfo> {\n    return EvsKitNative.getGlassesInfo();\n  },\n  turnOff() {\n    return EvsKitNative.turnGlassesOff();\n  },\n};\n\n/** Mirrors IEvsDisplayService (`Evs.instance().display()`) plus screen offset controls. */\nexport const EvsDisplay = {\n  turnOn() {\n    return EvsKitNative.turnDisplayOn();\n  },\n  /** Continuous scale, 1-255. Prefer setBrightnessLevel() where possible. */\n  setBrightness(value: number) {\n    return EvsKitNative.setBrightness(value);\n  },\n  /** Discrete brightness level via the SDK's display-optimized controller. */\n  setBrightnessLevel(level: number) {\n    return EvsKitNative.setBrightnessLevel(level);\n  },\n  setAutoBrightness(options: EvsAutoBrightnessOptions) {\n    return EvsKitNative.setAutoBrightness(options);\n  },\n  /** Adjust the virtual rendering area's center offset within the 640x400 display. */\n  setRenderingCenter(dx: number, dy: number) {\n    return Promise.all([\n      EvsKitNative.setRenderingCenterX(dx),\n      EvsKitNative.setRenderingCenterY(dy),\n    ]);\n  },\n};\n\n/**\n * Mirrors IEvsSensorsService (`Evs.instance().sensors()`).\n * Remember to disable sensors and unsubscribe events when no longer needed —\n * the SDK docs call this out explicitly for battery/bandwidth reasons.\n */\nexport const EvsSensors = {\n  enableTouch(enabled: boolean) {\n    return EvsKitNative.enableTouch(enabled);\n  },\n  enableAmbient(enabled: boolean) {\n    return EvsKitNative.enableAmbient(enabled);\n  },\n  enableGyro(enabled: boolean) {\n    return EvsKitNative.enableGyro(enabled);\n  },\n  enableMagnetometer(enabled: boolean) {\n    return EvsKitNative.enableMagnetometer(enabled);\n  },\n  enableAccelerometer(enabled: boolean) {\n    return EvsKitNative.enableAccelerometer(enabled);\n  },\n  /** Enables Gyro + Magnetometer + Accelerometer and starts the fusion algorithm. */\n  enableFusion(enabled: boolean) {\n    return EvsKitNative.enableSensorsFusion(enabled);\n  },\n};\n\n/** Mirrors IEvsAuthService (`Evs.instance().auth()`). Usually unnecessary — see API Keys docs. */\nexport const EvsAuth = {\n  setApiKeyName(fileNameWithoutExt: string) {\n    return EvsKitNative.setApiKeyName(fileNameWithoutExt);\n  },\n  setApiKey(base64Key: string) {\n    return EvsKitNative.setApiKey(base64Key);\n  },\n};\n\n/** Mirrors `Evs.instance().showUI(...)` — the SDK's built-in portrait UI screens. */\nexport const EvsUI = {\n  show(screen: EvsStockUIScreen) {\n    return EvsKitNative.showUI(screen);\n  },\n};\n\n/** Top-level lifecycle, matching `Evs.init(context).start()` / `Evs.instance().start()`. */\nexport const EvsKit = {\n  start() {\n    return EvsKitNative.start();\n  },\n  isStarted() {\n    return EvsKitNative.isStarted();\n  },\n  comm: EvsComm,\n  glasses: EvsGlasses,\n  display: EvsDisplay,\n  sensors: EvsSensors,\n  auth: EvsAuth,\n  ui: EvsUI,\n};\n\nexport default EvsKit;\n\n// ---------------------------------------------------------------------------\n// Event subscription helpers\n// ---------------------------------------------------------------------------\n\n/** Subscribe to a single EvsKit event; call the returned function to unsubscribe. */\nexport function addEvsKitListener<K extends keyof EvsKitEvents>(\n  eventName: K,\n  listener: EvsKitEvents[K],\n): EventSubscription {\n  return EvsKitNative.addListener(eventName, listener as any);\n}\n\n/**\n * React hook that subscribes to an EvsKit event for the lifetime of the\n * component. Pass a stable callback (e.g. via useCallback) to avoid\n * resubscribing every render.\n *\n * @example\n * useEvsKitEvent('onTouch', (direction) => {\n *   if (direction === 'tap') showPopup();\n * });\n */\nexport function useEvsKitEvent<K extends keyof EvsKitEvents>(\n  eventName: K,\n  listener: EvsKitEvents[K],\n) {\n  useEffect(() => {\n    const subscription = addEvsKitListener(eventName, listener);\n    return () => subscription.remove();\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [eventName, listener]);\n}\n"]}

package/expo-module.config.json

@@ -0,0 +1,9 @@
+{
+  "platforms": ["apple", "android"],
+  "apple": {
+    "modules": ["EvsKitModule"]
+  },
+  "android": {
+    "modules": ["expo.modules.evskit.EvsKitModule"]
+  }
+}

package/ios/EvsKit.xcframework/Info.plist

@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>AvailableLibraries</key>
+	<array>
+		<dict>
+			<key>BinaryPath</key>
+			<string>EvsKit.framework/EvsKit</string>
+			<key>LibraryIdentifier</key>
+			<string>ios-arm64</string>
+			<key>LibraryPath</key>
+			<string>EvsKit.framework</string>
+			<key>SupportedArchitectures</key>
+			<array>
+				<string>arm64</string>
+			</array>
+			<key>SupportedPlatform</key>
+			<string>ios</string>
+		</dict>
+		<dict>
+			<key>BinaryPath</key>
+			<string>EvsKit.framework/EvsKit</string>
+			<key>LibraryIdentifier</key>
+			<string>ios-arm64_x86_64-simulator</string>
+			<key>LibraryPath</key>
+			<string>EvsKit.framework</string>
+			<key>SupportedArchitectures</key>
+			<array>
+				<string>arm64</string>
+				<string>x86_64</string>
+			</array>
+			<key>SupportedPlatform</key>
+			<string>ios</string>
+			<key>SupportedPlatformVariant</key>
+			<string>simulator</string>
+		</dict>
+	</array>
+	<key>CFBundlePackageType</key>
+	<string>XFWK</string>
+	<key>XCFrameworkFormatVersion</key>
+	<string>1.0</string>
+</dict>
+</plist>