@therealitycrafters/react-native-evskit 0.1.0 → 0.1.2

package/android/src/main/java/expo/modules/evskit/EvsKitModule.kt

@@ -28,6 +28,8 @@ import UIKit.app.data.ProximityActionType
 import UIKit.app.data.YprData
 import UIKit.app.data.QuaternionData
 
+import UIKit.app.Viewport
+
 class DeviceInfoRecord : Record {
   @Field val deviceId: String = ""
   @Field val name: String = ""
@@ -44,6 +46,12 @@ class EvsKitModule : Module() {
   private var glassesEventsHandle: IEvsGlassesEvents? = null
   private var sensorsEventsHandle: IEvsSensorsEvents? = null
 
+  // Screens pushed via showScreen(id:), keyed by the JS-facing id so
+  // removeScreen(id:) can resolve the native instance. Viewport covers
+  // Screen, FullScreen and ArScreen.
+  private val activeScreens = mutableMapOf<String, Viewport>()
+  private val activeScreenOrder = mutableListOf<String>()
+
   override fun definition() = ModuleDefinition {
     Name("RNEvsKit")
 
@@ -61,6 +69,7 @@ class EvsKitModule : Module() {
 
     OnCreate {
       registerNativeListeners()
+      loadAppScreens()
     }
 
     OnDestroy {
@@ -97,6 +106,69 @@ class EvsKitModule : Module() {
       }
     }
 
+    // --- App-owned screens (IEvsScreenService) -------------------------------
+    //
+    // The bridge ships no Screen subclasses. Apps register their own via
+    // EvsScreenRegistry.register(id, factory) from app-owned Kotlin sources
+    // (linked at prebuild by the `screens` plugin option), then push them
+    // from JS with showScreen(id:).
+
+    AsyncFunction("showScreen") { id: String, promise: Promise ->
+      try {
+        val screen = EvsScreenRegistry.make(id)
+          ?: throw IllegalArgumentException(
+            "No screen registered for id '$id'. " +
+            "Register it via EvsScreenRegistry.register(id, factory) " +
+            "from app-owned Kotlin sources."
+          )
+        Evs.instance().screens().addScreen(screen)
+        if (!activeScreens.containsKey(id)) {
+          activeScreenOrder.add(id)
+        }
+        activeScreens[id] = screen
+        promise.resolve(null)
+      } catch (e: Exception) {
+        promise.reject("EVSKIT_SHOW_SCREEN_FAILED", e.message, e)
+      }
+    }
+
+    AsyncFunction("removeScreen") { id: String, promise: Promise ->
+      try {
+        activeScreens.remove(id)?.let { screen ->
+          Evs.instance().screens().removeScreen(screen)
+          activeScreenOrder.remove(id)
+        }
+        promise.resolve(null)
+      } catch (e: Exception) {
+        promise.reject("EVSKIT_REMOVE_SCREEN_FAILED", e.message, e)
+      }
+    }
+
+    AsyncFunction("removeTopmostScreen") { promise: Promise ->
+      try {
+        val removed = Evs.instance().screens().removeTopmostScreen()
+        val id = if (removed != null) {
+          activeScreens.entries.firstOrNull { it.value === removed }?.key?.also { found ->
+            activeScreens.remove(found)
+            activeScreenOrder.remove(found)
+          }
+        } else null
+        promise.resolve(id)
+      } catch (e: Exception) {
+        promise.reject("EVSKIT_REMOVE_TOPMOST_SCREEN_FAILED", e.message, e)
+      }
+    }
+
+    AsyncFunction("getTopmostScreen") { promise: Promise ->
+      try {
+        val topmost = Evs.instance().screens().getTopmostScreen()
+        val id = activeScreens.entries.firstOrNull { it.value === topmost }?.key
+        promise.resolve(id)
+      } catch (e: Exception) {
+        promise.reject("EVSKIT_GET_TOPMOST_SCREEN_FAILED", e.message, e)
+      }
+    }
+
     // --- Communication (IEvsCommunicationService) -----------------------------
 
     AsyncFunction("setDeviceInfo") { info: DeviceInfoRecord, promise: Promise ->
@@ -313,6 +385,17 @@ class EvsKitModule : Module() {
   // `addEvsKitListener` / `useEvsKitEvent` instead of touching native code.
   // ---------------------------------------------------------------------------
 
+  // Triggers the plugin-generated app-screens registrar, if the app
+  // configured `screens.register`. Class.forName initializes the Kotlin
+  // object, running its init block. Absent = no app screens; ignore.
+  private fun loadAppScreens() {
+    try {
+      Class.forName("evs.screens.generated.EvsAppScreensGenerated")
+    } catch (_: ClassNotFoundException) {
+      // No app-owned screens configured — nothing to register.
+    }
+  }
+
   private fun registerNativeListeners() {
     glassesEventsHandle = object : IEvsGlassesEvents {
       override fun onTouch(touch: TouchDirection) {

package/android/src/main/java/expo/modules/evskit/EvsScreenRegistry.kt

@@ -0,0 +1,25 @@
+package expo.modules.evskit
+
+import UIKit.app.Viewport
+
+/**
+ * Generic app-owned screen registry.
+ *
+ * The bridge itself ships NO Screen subclasses. Each app registers its own
+ * Kotlin `Screen`/`FullScreen`/`ArScreen` subclasses under a string id
+ * (from app-owned sources linked at prebuild by the `screens` plugin
+ * option), then drives them from JS via `EvsScreens.show(id)`.
+ */
+object EvsScreenRegistry {
+  private val factories = mutableMapOf<String, () -> Viewport>()
+
+  fun register(id: String, factory: () -> Viewport) {
+    factories[id] = factory
+  }
+
+  fun unregister(id: String) {
+    factories.remove(id)
+  }
+
+  fun make(id: String): Viewport? = factories[id]?.invoke()
+}

package/app.plugin.js

@@ -0,0 +1,9 @@
+const withEverysightBundleResources = require('./plugin/withEverysightBundleResources');
+const withEvsScreens = require('./plugin/withEvsScreens');
+
+module.exports = (config = {}, { bundleResources = [], screens = {} } = {}) => {
+  let result = config;
+  result = withEverysightBundleResources(result, { bundleResources });
+  result = withEvsScreens(result, { screens });
+  return result;
+};

package/build/EvsKit.types.d.ts

@@ -58,6 +58,18 @@ export interface EvsQuaternionSample extends EvsSensorSample<EvsQuaternionData>
     calibrationStatus: CalibrationStatus;
 }
 export type EvsStockUIScreen = "configure" | "adjust" | "calibrate";
+/**
+ * String id of an app-owned native screen.
+ *
+ * The bridge ships no Screen subclasses. Each app registers its own
+ * Swift/Kotlin `Screen`/`FullScreen`/`ArScreen` subclasses via
+ * `EvsScreenRegistry.register(id, factory)` (iOS) /
+ * `EvsScreenRegistry.register(id, factory)` (Android) from app-owned
+ * sources — e.g. `<app>/evs-screens/ios/*.swift` linked at prebuild by the
+ * bridge config plugin's `screens` option — then pushes them with
+ * `EvsScreens.show(id)`.
+ */
+export type EvsScreenId = string;
 export interface EvsBeginAuthEvent {
     serial: string;
     fwVersion: number;

package/build/EvsKit.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EvsKit.types.d.ts","sourceRoot":"","sources":["../src/EvsKit.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,kBAAkB,GAC5B,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,gBAAgB,GAAG,OAAO,CAAC;AAM3E,MAAM,WAAW,cAAc;IAC7B,iFAAiF;IACjF,YAAY,EAAE,MAAM,CAAC;IACrB,qFAAqF;IACrF,aAAa,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,sBAAsB,EAAE,MAAM,CAAC;IAC/B,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,CAAC;AAExE,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,CAAC;AAMlD,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,YAAY,GAAG,UAAU,CAAC;AAEzE,kGAAkG;AAClG,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/D,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,WAAW,YAAa,SAAQ,eAAe,CAAC,UAAU,CAAC;IAC/D,iBAAiB,EAAE,iBAAiB,CAAC;CACtC;AAED,MAAM,WAAW,mBAAoB,SAAQ,eAAe,CAAC,iBAAiB,CAAC;IAC7E,iBAAiB,EAAE,iBAAiB,CAAC;CACtC;AAMD,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAMpE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAOD,MAAM,MAAM,YAAY,GAAG;IACzB,wBAAwB,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC9D,WAAW,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAChD,oBAAoB,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IACrD,OAAO,EAAE,CAAC,SAAS,EAAE,cAAc,KAAK,IAAI,CAAC;IAC7C,WAAW,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC7C,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,KAAK,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IACtC,YAAY,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACpD,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC,CAAC"}
+{"version":3,"file":"EvsKit.types.d.ts","sourceRoot":"","sources":["../src/EvsKit.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,kBAAkB,GAC5B,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,gBAAgB,GAAG,OAAO,CAAC;AAM3E,MAAM,WAAW,cAAc;IAC7B,iFAAiF;IACjF,YAAY,EAAE,MAAM,CAAC;IACrB,qFAAqF;IACrF,aAAa,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,sBAAsB,EAAE,MAAM,CAAC;IAC/B,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,CAAC;AAExE,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,CAAC;AAMlD,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,YAAY,GAAG,UAAU,CAAC;AAEzE,kGAAkG;AAClG,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/D,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,WAAW,YAAa,SAAQ,eAAe,CAAC,UAAU,CAAC;IAC/D,iBAAiB,EAAE,iBAAiB,CAAC;CACtC;AAED,MAAM,WAAW,mBAAoB,SAAQ,eAAe,CAAC,iBAAiB,CAAC;IAC7E,iBAAiB,EAAE,iBAAiB,CAAC;CACtC;AAMD,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAMpE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAMjC,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAOD,MAAM,MAAM,YAAY,GAAG;IACzB,wBAAwB,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC9D,WAAW,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAChD,oBAAoB,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IACrD,OAAO,EAAE,CAAC,SAAS,EAAE,cAAc,KAAK,IAAI,CAAC;IAC7C,WAAW,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC7C,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,KAAK,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IACtC,YAAY,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACpD,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC,CAAC"}

package/build/EvsKit.types.js.map

@@ -1 +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"]}
+{"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// App-owned screens (IEvsScreenService via EvsScreenRegistry)\n// ---------------------------------------------------------------------------\n\n/**\n * String id of an app-owned native screen.\n *\n * The bridge ships no Screen subclasses. Each app registers its own\n * Swift/Kotlin `Screen`/`FullScreen`/`ArScreen` subclasses via\n * `EvsScreenRegistry.register(id, factory)` (iOS) /\n * `EvsScreenRegistry.register(id, factory)` (Android) from app-owned\n * sources — e.g. `<app>/evs-screens/ios/*.swift` linked at prebuild by the\n * bridge config plugin's `screens` option — then pushes them with\n * `EvsScreens.show(id)`.\n */\nexport type EvsScreenId = string;\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

@@ -28,6 +28,18 @@ declare class EvsKitNativeModule extends NativeModule<EvsKitEvents> {
     setAutoBrightness(options: EvsAutoBrightnessOptions): Promise<void>;
     setRenderingCenterX(dx: number): Promise<void>;
     setRenderingCenterY(dy: number): Promise<void>;
+    /**
+     * Push an app-registered screen onto the glasses screen stack.
+     * Rejects with EVSKIT_SHOW_SCREEN_FAILED / EVSKIT_UNKNOWN_SCREEN when no
+     * factory is registered for `id`.
+     */
+    showScreen(id: string): Promise<void>;
+    /** Remove a previously shown screen by id. No-op when unknown. */
+    removeScreen(id: string): Promise<void>;
+    /** Pop the topmost screen; resolves with its id, or null when empty/untracked. */
+    removeTopmostScreen(): Promise<string | null>;
+    /** Resolve the topmost tracked screen id, or null. */
+    getTopmostScreen(): Promise<string | null>;
     enableTouch(enabled: boolean): Promise<void>;
     enableAmbient(enabled: boolean): Promise<void>;
     enableGyro(enabled: boolean): Promise<void>;

package/build/EvsKitModule.d.ts.map

@@ -1 +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"}
+{"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;;;;OAIG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACrC,kEAAkE;IAClE,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACvC,kFAAkF;IAClF,mBAAmB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAC7C,sDAAsD;IACtD,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAG1C,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.map

@@ -1 +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"]}
+{"version":3,"file":"EvsKitModule.js","sourceRoot":"","sources":["../src/EvsKitModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AA8EtE,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  // --- App-owned screens (IEvsScreenService via EvsScreenRegistry) ------------\n  /**\n   * Push an app-registered screen onto the glasses screen stack.\n   * Rejects with EVSKIT_SHOW_SCREEN_FAILED / EVSKIT_UNKNOWN_SCREEN when no\n   * factory is registered for `id`.\n   */\n  showScreen(id: string): Promise<void>;\n  /** Remove a previously shown screen by id. No-op when unknown. */\n  removeScreen(id: string): Promise<void>;\n  /** Pop the topmost screen; resolves with its id, or null when empty/untracked. */\n  removeTopmostScreen(): Promise<string | null>;\n  /** Resolve the topmost tracked screen id, or null. */\n  getTopmostScreen(): Promise<string | null>;\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

@@ -1,5 +1,5 @@
 import type { EventSubscription } from "expo-modules-core";
-import type { EvsAutoBrightnessOptions, EvsDeviceInfo, EvsGlassesInfo, EvsKitEvents, EvsStockUIScreen } from "./EvsKit.types";
+import type { EvsAutoBrightnessOptions, EvsDeviceInfo, EvsGlassesInfo, EvsKitEvents, EvsScreenId, EvsStockUIScreen } from "./EvsKit.types";
 export * from "./EvsKit.types";
 /**
  * Communication service — mirrors IEvsCommunicationService
@@ -58,6 +58,23 @@ export declare const EvsAuth: {
 export declare const EvsUI: {
     show(screen: EvsStockUIScreen): Promise<void>;
 };
+/**
+ * App-owned glasses screens (`Evs.instance().screens()`).
+ *
+ * The bridge ships no Screen subclasses. Register yours natively per app —
+ * `EvsScreenRegistry.register(id, factory)` from app-owned Swift/Kotlin
+ * sources (linked at prebuild by the plugin's `screens` option) — then push
+ * them from JS:
+ *
+ * @example
+ * await EvsScreens.show("hello-world");
+ */
+export declare const EvsScreens: {
+    show(id: EvsScreenId): Promise<void>;
+    remove(id: EvsScreenId): Promise<void>;
+    removeTopmost(): Promise<string | null>;
+    getTopmost(): Promise<string | null>;
+};
 /** Top-level lifecycle, matching `Evs.init(context).start()` / `Evs.instance().start()`. */
 export declare const EvsKit: {
     start(): Promise<void>;
@@ -100,6 +117,12 @@ export declare const EvsKit: {
     ui: {
         show(screen: EvsStockUIScreen): Promise<void>;
     };
+    screens: {
+        show(id: EvsScreenId): Promise<void>;
+        remove(id: EvsScreenId): Promise<void>;
+        removeTopmost(): Promise<string | null>;
+        getTopmost(): Promise<string | null>;
+    };
 };
 export default EvsKit;
 /** Subscribe to a single EvsKit event; call the returned function to unsubscribe. */

package/build/index.d.ts.map

@@ -1 +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"}
+{"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,WAAW,EACX,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;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU;aACZ,WAAW;eAGT,WAAW;;;CASvB,CAAC;AAEF,4FAA4F;AAC5F,eAAO,MAAM,MAAM;;;;4BA5HG,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;;;iBAiBpB,WAAW;mBAGT,WAAW;;;;CA0BvB,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

@@ -103,6 +103,31 @@ export const EvsUI = {
         return EvsKitNative.showUI(screen);
     },
 };
+/**
+ * App-owned glasses screens (`Evs.instance().screens()`).
+ *
+ * The bridge ships no Screen subclasses. Register yours natively per app —
+ * `EvsScreenRegistry.register(id, factory)` from app-owned Swift/Kotlin
+ * sources (linked at prebuild by the plugin's `screens` option) — then push
+ * them from JS:
+ *
+ * @example
+ * await EvsScreens.show("hello-world");
+ */
+export const EvsScreens = {
+    show(id) {
+        return EvsKitNative.showScreen(id);
+    },
+    remove(id) {
+        return EvsKitNative.removeScreen(id);
+    },
+    removeTopmost() {
+        return EvsKitNative.removeTopmostScreen();
+    },
+    getTopmost() {
+        return EvsKitNative.getTopmostScreen();
+    },
+};
 /** Top-level lifecycle, matching `Evs.init(context).start()` / `Evs.instance().start()`. */
 export const EvsKit = {
     start() {
@@ -117,6 +142,7 @@ export const EvsKit = {
     sensors: EvsSensors,
     auth: EvsAuth,
     ui: EvsUI,
+    screens: EvsScreens,
 };
 export default EvsKit;
 // ---------------------------------------------------------------------------

package/build/index.js.map

@@ -1 +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"]}
+{"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  EvsScreenId,\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/**\n * App-owned glasses screens (`Evs.instance().screens()`).\n *\n * The bridge ships no Screen subclasses. Register yours natively per app —\n * `EvsScreenRegistry.register(id, factory)` from app-owned Swift/Kotlin\n * sources (linked at prebuild by the plugin's `screens` option) — then push\n * them from JS:\n *\n * @example\n * await EvsScreens.show(\"hello-world\");\n */\nexport const EvsScreens = {\n  show(id: EvsScreenId) {\n    return EvsKitNative.showScreen(id);\n  },\n  remove(id: EvsScreenId) {\n    return EvsKitNative.removeScreen(id);\n  },\n  removeTopmost() {\n    return EvsKitNative.removeTopmostScreen();\n  },\n  getTopmost() {\n    return EvsKitNative.getTopmostScreen();\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  screens: EvsScreens,\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/ios/EvsKitModule.swift

@@ -23,6 +23,12 @@ public class EvsKitModule: Module {
   private var yprEventsHandle: YprEventsHandler?
   private var quaternionEventsHandle: QuaternionEventsHandler?
 
+  /// Screens pushed via showScreen(id:), keyed by the JS-facing id so
+  /// removeScreen(id:) can resolve the native instance. Viewport covers
+  /// Screen, FullScreen and ArScreen.
+  private var activeScreens: [String: Viewport] = [:]
+  private var activeScreenOrder: [String] = []
+
   public func definition() -> ModuleDefinition {
     Name("RNEvsKit")
 
@@ -71,6 +77,58 @@ public class EvsKitModule: Module {
       }
     }
 
+    // --- App-owned screens (IEvsScreenService) --------------------------------
+    //
+    // The bridge ships no Screen subclasses. Apps register their own via
+    // EvsScreenRegistry.register(id:factory:) from app-owned Swift sources
+    // (linked at prebuild by the `screens` plugin option), then push them
+    // from JS with showScreen(id:).
+
+    AsyncFunction("showScreen") { (id: String) -> Void in
+      await MainActor.run { () -> Void in
+        guard let screen = EvsScreenRegistry.make(id: id) else {
+          throw Exception(
+            name: "EVSKIT_UNKNOWN_SCREEN",
+            description: "No screen registered for id '\(id)'. "
+              + "Register it via EvsScreenRegistry.register(id:factory:) "
+              + "from app-owned Swift sources."
+          )
+        }
+        Evs.instance().screens().addScreen(screen: screen)
+        if self.activeScreens[id] == nil {
+          self.activeScreenOrder.append(id)
+        }
+        self.activeScreens[id] = screen
+      }
+    }
+
+    AsyncFunction("removeScreen") { (id: String) -> Void in
+      await MainActor.run { () -> Void in
+        guard let screen = self.activeScreens[id] else { return }
+        Evs.instance().screens().removeScreen(screen: screen)
+        self.activeScreens.removeValue(forKey: id)
+        self.activeScreenOrder.removeAll { $0 == id }
+      }
+    }
+
+    AsyncFunction("removeTopmostScreen") { () -> String? in
+      await MainActor.run { () -> String? in
+        let removed: Viewport? = Evs.instance().screens().removeTopmostScreen()
+        guard let removed else { return nil }
+        if let id = self.activeScreens.first(where: { $0.value === removed })?.key {
+          self.activeScreens.removeValue(forKey: id)
+          self.activeScreenOrder.removeAll { $0 == id }
+          return id
+        }
+        return nil
+      }
+    }
+
+    AsyncFunction("getTopmostScreen") { () -> String? in
+      let topmost = Evs.instance().screens().getTopmostScreen()
+      return self.activeScreens.first(where: { $0.value === topmost })?.key
+    }
+
     // --- Communication (IEvsCommunicationService) -----------------------------
 
     AsyncFunction("setDeviceInfo") { (info: DeviceInfoRecord) -> Void in

package/ios/EvsScreenRegistry.swift

@@ -0,0 +1,26 @@
+import NativeEvsKit
+
+/// Generic app-owned screen registry.
+///
+/// The bridge itself ships NO Screen subclasses. Each app registers its own
+/// Swift `Screen`/`FullScreen`/`ArScreen` subclasses under a string id, then
+/// drives them from JS via `EvsScreens.show(id)`.
+///
+/// App screens live in app source (e.g. `<app>/evs-screens/ios/*.swift`),
+/// linked into the app target at prebuild by the `screens` config-plugin
+/// option — so wiping `ios/` and re-running `expo prebuild` loses nothing.
+public enum EvsScreenRegistry {
+  public static var factories: [String: () -> Viewport] = [:]
+
+  public static func register(id: String, factory: @escaping () -> Viewport) {
+    factories[id] = factory
+  }
+
+  public static func unregister(id: String) {
+    factories.removeValue(forKey: id)
+  }
+
+  public static func make(id: String) -> Viewport? {
+    factories[id]?()
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@therealitycrafters/react-native-evskit",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "React Native / Expo bridge for Everysight's Maverick SDK (EvsKit + NativeEvsKit)",
   "author": "Patrick Catanzariti",
   "homepage": "https://therealitycrafters.com",
@@ -17,6 +17,8 @@
     "src",
     "android",
     "ios",
+    "plugin",
+    "app.plugin.js",
     "expo-module.config.json"
   ],
   "scripts": {

package/plugin/withEverysightBundleResources.js

@@ -0,0 +1,110 @@
+const { withXcodeProject } = require("@expo/config-plugins");
+const path = require("path");
+
+/**
+ * Config plugin that adds files (e.g. sdk.key, app.key) as Xcode bundle
+ * resources so they are included in the app binary.
+ *
+ * Usage in app.config.ts:
+ *   plugins: [
+ *     ['react-native-evskit', { bundleResources: ['./sdk.key'] }],
+ *   ]
+ *
+ * Adds PBXBuildFile + PBXFileReference entries directly to the pbxproj
+ * objects, avoiding the pbxFile constructor which produces undefined values
+ * that CocoaPods cannot parse.
+ */
+function withEverysightBundleResources(config, { bundleResources = [] } = {}) {
+  if (!bundleResources.length) {
+    return config;
+  }
+
+  return withXcodeProject(config, (config) => {
+    const project = config.modResults;
+    const objects = project.hash.project.objects;
+
+    // Initialize required object sections
+    objects.PBXBuildFile = objects.PBXBuildFile || {};
+    objects.PBXFileReference = objects.PBXFileReference || {};
+
+    for (const relativePath of bundleResources) {
+      const resolvedPath = path.join(
+        config.modRequest.projectRoot,
+        relativePath,
+      );
+      const fileName = path.basename(resolvedPath);
+
+      // Skip if already exists
+      const existingRef = Object.keys(objects.PBXFileReference).find(
+        (key) =>
+          !key.endsWith("_comment") &&
+          objects.PBXFileReference[key].name === fileName,
+      );
+      if (existingRef) continue;
+
+      // The Xcode project lives in <projectRoot>/ios, so the file reference
+      // path must be relative to that directory (e.g. "../sdk.key").
+      const iosDir = path.join(config.modRequest.projectRoot, "ios");
+      const relativeToIos = path.relative(iosDir, resolvedPath);
+
+      // Create PBXFileReference
+      const fileRefUuid = project.generateUuid();
+      objects.PBXFileReference[fileRefUuid] = {
+        isa: "PBXFileReference",
+        name: `"${fileName}"`,
+        path: `"${relativeToIos}"`,
+        // Quotes must be embedded in the string: the `xcode` lib's pbxWriter
+        // does not add quotes itself, and angle brackets (<>) are invalid
+        // unquoted in the pbxproj format (e.g. `sourceTree = "<group>";`).
+        sourceTree: '"<group>"',
+      };
+      objects.PBXFileReference[`${fileRefUuid}_comment`] = fileName;
+
+      // Create PBXBuildFile
+      const buildFileUuid = project.generateUuid();
+      objects.PBXBuildFile[buildFileUuid] = {
+        isa: "PBXBuildFile",
+        fileRef: fileRefUuid,
+      };
+      objects.PBXBuildFile[`${buildFileUuid}_comment`] =
+        `${fileName} in Resources`;
+
+      // Add to Resources build phase
+      const target = project.getFirstTarget();
+      const nativeTarget = objects.PBXNativeTarget[target.uuid];
+      const resourcesPhaseUuid = nativeTarget.buildPhases.find((phase) =>
+        /Resources/i.test(phase.comment || ""),
+      )?.value;
+      if (resourcesPhaseUuid && objects.PBXResourcesBuildPhase) {
+        const resourcesPhase =
+          objects.PBXResourcesBuildPhase[resourcesPhaseUuid];
+        if (resourcesPhase) {
+          resourcesPhase.files = resourcesPhase.files || [];
+          resourcesPhase.files.push({
+            value: buildFileUuid,
+            comment: `${fileName} in Resources`,
+          });
+        }
+      }
+
+      // Add to Resources group
+      const resourcesGroupKey = Object.keys(objects.PBXGroup || {}).find(
+        (key) =>
+          !key.endsWith("_comment") &&
+          objects.PBXGroup[key].name === "Resources",
+      );
+      if (resourcesGroupKey) {
+        objects.PBXGroup[resourcesGroupKey].children =
+          objects.PBXGroup[resourcesGroupKey].children || [];
+        objects.PBXGroup[resourcesGroupKey].children.push({
+          value: fileRefUuid,
+          comment: fileName,
+        });
+      }
+    }
+
+    return config;
+  });
+}
+
+module.exports = withEverysightBundleResources;

package/plugin/withEverysightSPM.js

@@ -0,0 +1,276 @@
+const { withXcodeProject } = require("@expo/config-plugins");
+const fs = require("fs");
+const path = require("path");
+
+/**
+ * Adds Everysight's Maverick SDK (EvsKit + NativeEvsKit) as a Swift Package
+ * Manager dependency of the iOS app target during `expo prebuild`.
+ *
+ * Why this exists: CocoaPods can't consume SPM packages, and the SDK is
+ * only distributed via SPM (github.com/everysight-maverick/m1-ios-spm),
+ * which itself is just a `Package.swift` pointing at two prebuilt
+ * `EvsKit.xcframework.zip` / `NativeEvsKit.xcframework.zip` binary targets
+ * (confirmed by reading that repo directly — there's no source in it).
+ * Without this plugin you'd have to re-add the package by hand in Xcode
+ * every time you run a clean prebuild, which defeats the point of managed
+ * config.
+ *
+ * Implementation note: `@expo/config-plugins` / the underlying `xcode` npm
+ * package has no first-class API for SPM package references (it predates
+ * SPM support landing in most versions of that library), so this writes the
+ * `XCRemoteSwiftPackageReference` / `XCSwiftPackageProductDependency`
+ * pbxproj objects directly. That's inherently more fragile than a proper
+ * API — it's been structured to be idempotent (safe to run on every
+ * prebuild) and defensive about missing sections, but if a future Xcode
+ * project format changes the relevant object shapes, this may need
+ * updating. If it ever misbehaves, the fallback is adding the package by
+ * hand via Xcode's File > Add Packages... using the same URL/version below,
+ * then removing this plugin.
+ *
+ * @param {import('@expo/config-plugins').ExportedConfig} config
+ * @param {{ version?: string }} [options]
+ */
+function withEverysightSPM(config, options = {}) {
+  const packageURL = "https://github.com/everysight-maverick/m1-ios-spm.git";
+  const versionRequirement = options.version ?? "2.6.1";
+  const products = ["EvsKit", "NativeEvsKit"];
+
+  config = withXcodeProject(config, (config) => {
+    const project = config.modResults;
+    addSwiftPackage(project, packageURL, versionRequirement, products);
+    addModuleSourcesToAppTarget(project, config.modRequest.projectRoot);
+    return config;
+  });
+
+  return config;
+}
+
+/**
+ * Registers a remote Swift package (with an exact-version requirement) and
+ * links the given product names against the app's first native target.
+ * Safe to call repeatedly — checks for an existing reference/dependency
+ * before adding a duplicate.
+ */
+function addSwiftPackage(project, repositoryURL, exactVersion, productNames) {
+  const objects = project.hash.project.objects;
+  objects.XCRemoteSwiftPackageReference =
+    objects.XCRemoteSwiftPackageReference || {};
+  objects.XCSwiftPackageProductDependency =
+    objects.XCSwiftPackageProductDependency || {};
+
+  // --- 1. Find or create the XCRemoteSwiftPackageReference ------------------
+  let packageRefUuid = Object.keys(objects.XCRemoteSwiftPackageReference).find(
+    (key) =>
+      !key.endsWith("_comment") &&
+      objects.XCRemoteSwiftPackageReference[key].repositoryURL ===
+        JSON.stringify(repositoryURL),
+  );
+
+  if (!packageRefUuid) {
+    packageRefUuid = project.generateUuid();
+    objects.XCRemoteSwiftPackageReference[packageRefUuid] = {
+      isa: "XCRemoteSwiftPackageReference",
+      repositoryURL: JSON.stringify(repositoryURL),
+      requirement: {
+        kind: "exactVersion",
+        version: exactVersion,
+      },
+    };
+    objects.XCRemoteSwiftPackageReference[`${packageRefUuid}_comment`] =
+      'XCRemoteSwiftPackageReference "m1-ios-spm"';
+
+    // Register the reference on the project object itself
+    // (Xcode reads packageReferences off PBXProject, not just the target).
+    const rootObjectUuid = project.hash.project.rootObject;
+    const rootObject = objects.PBXProject[rootObjectUuid];
+    rootObject.packageReferences = rootObject.packageReferences || [];
+    if (
+      !rootObject.packageReferences.some((ref) => ref.value === packageRefUuid)
+    ) {
+      rootObject.packageReferences.push({
+        value: packageRefUuid,
+        comment: 'XCRemoteSwiftPackageReference "m1-ios-spm"',
+      });
+    }
+  }
+
+  // --- 2. Find or create a XCSwiftPackageProductDependency per product ------
+  const target = project.getFirstTarget();
+  const nativeTarget = objects.PBXNativeTarget[target.uuid];
+  nativeTarget.packageProductDependencies =
+    nativeTarget.packageProductDependencies || [];
+
+  // Also link SPM products to the pod target (RNEvsKit) so that the Swift
+  // module can import EvsKit and NativeEvsKit. The pod is compiled as a
+  // separate target and needs the SPM products linked to it.
+  const podTargetUuid = Object.keys(objects.PBXNativeTarget).find(
+    (key) =>
+      !key.endsWith("_comment") &&
+      objects.PBXNativeTarget[key].productReference &&
+      objects.PBXNativeTarget[key].buildConfigurationList,
+  );
+  const podTarget = podTargetUuid
+    ? objects.PBXNativeTarget[podTargetUuid]
+    : null;
+
+  const frameworksBuildPhaseUuid = nativeTarget.buildPhases.find((phase) =>
+    /Frameworks/i.test(phase.comment || ""),
+  )?.value;
+  const frameworksPhase = frameworksBuildPhaseUuid
+    ? objects.PBXFrameworksBuildPhase[frameworksBuildPhaseUuid]
+    : undefined;
+
+  for (const productName of productNames) {
+    let productDepUuid = Object.keys(
+      objects.XCSwiftPackageProductDependency,
+    ).find(
+      (key) =>
+        !key.endsWith("_comment") &&
+        objects.XCSwiftPackageProductDependency[key].productName ===
+          productName,
+    );
+
+    if (!productDepUuid) {
+      productDepUuid = project.generateUuid();
+      objects.XCSwiftPackageProductDependency[productDepUuid] = {
+        isa: "XCSwiftPackageProductDependency",
+        package: packageRefUuid,
+        productName,
+      };
+      objects.XCSwiftPackageProductDependency[`${productDepUuid}_comment`] =
+        productName;
+    }
+
+    // Add to app target
+    if (
+      !nativeTarget.packageProductDependencies.some(
+        (dep) => dep.value === productDepUuid,
+      )
+    ) {
+      nativeTarget.packageProductDependencies.push({
+        value: productDepUuid,
+        comment: productName,
+      });
+    }
+
+    // Also add to pod target (RNEvsKit) so the Swift module can import these
+    if (podTarget) {
+      podTarget.packageProductDependencies =
+        podTarget.packageProductDependencies || [];
+      if (
+        !podTarget.packageProductDependencies.some(
+          (dep) => dep.value === productDepUuid,
+        )
+      ) {
+        podTarget.packageProductDependencies.push({
+          value: productDepUuid,
+          comment: productName,
+        });
+      }
+    }
+
+    // Link the product into the app binary via the Frameworks build phase,
+    // same as Xcode would if you added it through the UI.
+    if (frameworksPhase) {
+      objects.PBXBuildFile = objects.PBXBuildFile || {};
+      const alreadyLinked = Object.keys(objects.PBXBuildFile).some(
+        (key) =>
+          !key.endsWith("_comment") &&
+          objects.PBXBuildFile[key].productRef === productDepUuid,
+      );
+
+      if (!alreadyLinked) {
+        const buildFileUuid = project.generateUuid();
+        objects.PBXBuildFile[buildFileUuid] = {
+          isa: "PBXBuildFile",
+          productRef: productDepUuid,
+          productRef_comment: productName,
+        };
+        objects.PBXBuildFile[`${buildFileUuid}_comment`] =
+          `${productName} in Frameworks`;
+
+        frameworksPhase.files = frameworksPhase.files || [];
+        frameworksPhase.files.push({
+          value: buildFileUuid,
+          comment: `${productName} in Frameworks`,
+        });
+      }
+    }
+  }
+}
+
+/**
+ * Adds the EvsKitModule.swift source files directly to the app target's
+ * Sources build phase so they can import SPM products (EvsKit, NativeEvsKit).
+ * CocoaPods targets cannot consume SPM packages, so the podspec has empty
+ * source_files and the actual sources are compiled via the app target instead.
+ */
+function addModuleSourcesToAppTarget(project, projectRoot) {
+  const objects = project.hash.project.objects;
+  const target = project.getFirstTarget();
+  const nativeTarget = objects.PBXNativeTarget[target.uuid];
+
+  // Find the Sources build phase
+  const sourcesPhaseUuid = nativeTarget.buildPhases.find((phase) =>
+    /Sources/i.test(phase.comment || ""),
+  )?.value;
+  const sourcesPhase = sourcesPhaseUuid
+    ? objects.PBXSourcesBuildPhase[sourcesPhaseUuid]
+    : undefined;
+  if (!sourcesPhase) return;
+
+  const moduleDir = path.join(path.dirname(__dirname), "ios");
+  const sourceFiles = fs
+    .readdirSync(moduleDir)
+    .filter((f) => f.endsWith(".swift"));
+
+  // The Xcode project lives in <projectRoot>/ios, so the file reference path
+  // must be relative to that directory (e.g. "../../react-native-evskit/ios").
+  const iosDir = path.join(projectRoot, "ios");
+  const moduleDirRelativeToIos = path.relative(iosDir, moduleDir);
+
+  for (const fileName of sourceFiles) {
+    // Check if already added
+    const alreadyAdded = Object.keys(objects.PBXBuildFile || {}).some(
+      (key) =>
+        !key.endsWith("_comment") &&
+        objects.PBXBuildFile[key].fileRef &&
+        objects.PBXBuildFile[key].fileRef_comment === fileName,
+    );
+    if (alreadyAdded) continue;
+
+    // Add file reference
+    const fileRefUuid = project.generateUuid();
+    objects.PBXFileReference = objects.PBXFileReference || {};
+    objects.PBXFileReference[fileRefUuid] = {
+      isa: "PBXFileReference",
+      explicitFileType: "sourcecode.swift",
+      fileEncoding: 4,
+      name: fileName,
+      path: path.join(moduleDirRelativeToIos, fileName),
+      // Quotes must be embedded in the string: the `xcode` lib's pbxWriter
+      // does not add quotes itself, and angle brackets (<>) are invalid
+      // unquoted in the pbxproj format (e.g. `sourceTree = "<group>";`).
+      sourceTree: '"<group>"',
+    };
+    objects.PBXFileReference[`${fileRefUuid}_comment`] = fileName;
+
+    // Add build file
+    const buildFileUuid = project.generateUuid();
+    objects.PBXBuildFile = objects.PBXBuildFile || {};
+    objects.PBXBuildFile[buildFileUuid] = {
+      isa: "PBXBuildFile",
+      fileRef: fileRefUuid,
+    };
+    objects.PBXBuildFile[`${buildFileUuid}_comment`] = `${fileName} in Sources`;
+
+    // Add to Sources build phase
+    sourcesPhase.files = sourcesPhase.files || [];
+    sourcesPhase.files.push({
+      value: buildFileUuid,
+      comment: `${fileName} in Sources`,
+    });
+  }
+}
+
+module.exports = withEverysightSPM;

package/plugin/withEvsScreens.js

@@ -0,0 +1,256 @@
+const { withAppBuildGradle, withXcodeProject } = require("@expo/config-plugins");
+const fs = require("fs");
+const path = require("path");
+
+// ---------------------------------------------------------------------------
+// Links app-owned Everysight glasses screens into the native build and
+// generates their registration with the bridge's EvsScreenRegistry.
+//
+// App screens live in app source (committed), e.g.:
+//
+//   <app>/evs-screens/ios/HelloWorldScreen.swift
+//   <app>/evs-screens/android/HelloWorldScreen.kt
+//
+// Usage in app.config.ts:
+//
+//   plugins: [
+//     ['react-native-evskit', {
+//       bundleResources: ['./sdk.key'],
+//       screens: {
+//         ios: './evs-screens/ios',
+//         android: './evs-screens/android',
+//         // id -> class name. Swift: class name in the app target.
+//         // Kotlin: fully-qualified class name.
+//         register: {
+//           'hello-world': {
+//             ios: 'HelloWorldScreen',
+//             android: 'com.sampleevskitproject.screens.HelloWorldScreen',
+//           },
+//         },
+//       },
+//     }],
+//   ]
+//
+// On `expo prebuild` this:
+// - iOS: adds each app-owned .swift file to the app target's Sources phase
+//   (path relative to ios/, e.g. "../evs-screens/ios/HelloWorldScreen.swift"),
+//   and writes a generated `ios/EvsAppScreens.generated.swift` that registers
+//   every id. The generated file self-registers via top-level statements, so
+//   no AppDelegate changes are needed.
+// - Android: registers the app-owned dir (plus a generated dir) as extra
+//   sourceSets java srcDirs, and writes a generated registrar object. The
+//   bridge loads it via Class.forName on startup (no-op when absent).
+//
+// The source of truth is the committed evs-screens/ folder plus the config,
+// and the plugin re-runs on every prebuild, so wiping ios/ + android/ loses
+// nothing. Push from JS with `await EvsScreens.show("hello-world")`.
+// ---------------------------------------------------------------------------
+const GENERATED_IOS_FILE = "EvsAppScreens.generated.swift";
+const GENERATED_ANDROID_DIR = "evs-screens-generated";
+const GENERATED_ANDROID_PACKAGE = "evs.screens.generated";
+const GENERATED_ANDROID_CLASS = "EvsAppScreensGenerated";
+
+function withEvsScreens(config, { screens = {} } = {}) {
+  const { ios: iosDir, android: androidDir, register = {} } = screens;
+  if (!iosDir && !androidDir) {
+    return config;
+  }
+  if (iosDir) {
+    config = withEvsIosScreens(config, iosDir, register);
+  }
+  if (androidDir) {
+    config = withEvsAndroidScreens(config, androidDir, register);
+  }
+  return config;
+}
+
+function listSourceFiles(absDir, ext) {
+  if (!fs.existsSync(absDir) || !fs.statSync(absDir).isDirectory()) {
+    return [];
+  }
+  return fs.readdirSync(absDir).filter((f) => f.endsWith(ext)).sort();
+}
+
+function toPosix(p) {
+  return p.split(path.sep).join("/");
+}
+
+function sanitize(id) {
+  return id.replace(/[^A-Za-z0-9_]/g, "_");
+}
+
+module.exports = withEvsScreens;
+function generatedIosContents(register) {
+  const lines = [
+    "// Generated by react-native-evskit — do not edit.",
+    "// Registers app-owned screens (see `screens.register` in app.config).",
+    "",
+    "import NativeEvsKit",
+    "import RNEvsKit",
+    "",
+  ];
+  for (const [id, entry] of Object.entries(register)) {
+    const className = typeof entry === "string" ? entry : entry.ios;
+    if (!className) {
+      continue;
+    }
+    lines.push(
+      `private let _evsRegister_${sanitize(id)}: Void = {`,
+      `  EvsScreenRegistry.register(id: ${JSON.stringify(id)}) { ${className}() }`,
+      `}()`,
+      "",
+    );
+  }
+  if (!Object.keys(register).length) {
+    lines.push("// No screens registered.", "");
+  }
+  return lines.join("\n");
+}
+
+function addSwiftFileToSources(project, objects, sourcesPhase, fileName, relativePath) {
+  const alreadyAdded = Object.keys(objects.PBXBuildFile).some(
+    (key) =>
+      !key.endsWith("_comment") &&
+      objects.PBXBuildFile[key].fileRef_comment === fileName,
+  );
+  if (alreadyAdded) {
+    return;
+  }
+  const fileRefUuid = project.generateUuid();
+  objects.PBXFileReference[fileRefUuid] = {
+    isa: "PBXFileReference",
+    explicitFileType: "sourcecode.swift",
+    fileEncoding: 4,
+    name: fileName,
+    path: relativePath,
+    // Quotes must be embedded: the `xcode` lib's pbxWriter does not add
+    // quotes itself, and angle brackets (<>) are invalid unquoted.
+    sourceTree: '"<group>"',
+  };
+  objects.PBXFileReference[`${fileRefUuid}_comment`] = fileName;
+  const buildFileUuid = project.generateUuid();
+  objects.PBXBuildFile[buildFileUuid] = {
+    isa: "PBXBuildFile",
+    fileRef: fileRefUuid,
+    fileRef_comment: fileName,
+  };
+  objects.PBXBuildFile[`${buildFileUuid}_comment`] =
+    `${fileName} in Sources`;
+  sourcesPhase.files = sourcesPhase.files || [];
+  sourcesPhase.files.push({
+    value: buildFileUuid,
+    comment: `${fileName} in Sources`,
+  });
+}
+
+function withEvsIosScreens(config, iosScreensDir, register) {
+  return withXcodeProject(config, (config) => {
+    const projectRoot = config.modRequest.projectRoot;
+    const absDir = path.join(projectRoot, iosScreensDir);
+    const files = listSourceFiles(absDir, ".swift");
+    const project = config.modResults;
+    const objects = project.hash.project.objects;
+    objects.PBXBuildFile = objects.PBXBuildFile || {};
+    objects.PBXFileReference = objects.PBXFileReference || {};
+    const target = project.getFirstTarget();
+    const nativeTarget = objects.PBXNativeTarget[target.uuid];
+    const sourcesPhaseUuid = nativeTarget.buildPhases.find((phase) =>
+      /Sources/i.test(phase.comment || ""),
+    )?.value;
+    const sourcesPhase = sourcesPhaseUuid
+      ? objects.PBXSourcesBuildPhase[sourcesPhaseUuid]
+      : undefined;
+    if (!sourcesPhase) {
+      return config;
+    }
+    // The Xcode project lives in <projectRoot>/ios, so file reference paths
+    // must be relative to that directory (e.g. "../evs-screens/ios/X.swift").
+    const iosDir = path.join(projectRoot, "ios");
+    for (const fileName of files) {
+      addSwiftFileToSources(
+        project,
+        objects,
+        sourcesPhase,
+        fileName,
+        toPosix(path.join(path.relative(iosDir, absDir), fileName)),
+      );
+    }
+    // Generated registrar — written into the (regenerable) ios/ dir and
+    // linked the same way. Top-level `let` runs at binary load, so no
+    // AppDelegate changes are needed.
+    if (Object.keys(register).length) {
+      const generatedPath = path.join(iosDir, GENERATED_IOS_FILE);
+      fs.writeFileSync(generatedPath, generatedIosContents(register));
+      addSwiftFileToSources(
+        project,
+        objects,
+        sourcesPhase,
+        GENERATED_IOS_FILE,
+        GENERATED_IOS_FILE,
+      );
+    }
+    return config;
+  });
+}
+function generatedAndroidContents(register) {
+  const lines = [
+    `package ${GENERATED_ANDROID_PACKAGE}`,
+    "",
+    "// Generated by react-native-evskit — do not edit.",
+    "// Registers app-owned screens (see `screens.register` in app.config).",
+    "// Loaded via Class.forName from the bridge module's OnCreate.",
+    "",
+    "import expo.modules.evskit.EvsScreenRegistry",
+    "",
+    `object ${GENERATED_ANDROID_CLASS} {`,
+    "  init {",
+  ];
+  for (const [id, entry] of Object.entries(register)) {
+    const fqcn = typeof entry === "string" ? entry : entry.android;
+    if (!fqcn) {
+      continue;
+    }
+    const simple = fqcn.split(".").pop();
+    lines.push(`import ${fqcn}`);
+    lines.push(`    EvsScreenRegistry.register(${JSON.stringify(id)}) { ${simple}() }`);
+  }
+  lines.push("  }", "}");
+  return lines.join("\n");
+}
+
+function withEvsAndroidScreens(config, androidScreensDir, register) {
+  const projectRoot = config.modRequest.projectRoot;
+  // Write the generated registrar into a disposable dir under android/ and
+  // compile it via an extra srcDir (same mechanism as the app-owned dir).
+  if (Object.keys(register).length) {
+    const genDir = path.join(projectRoot, "android", GENERATED_ANDROID_DIR);
+    fs.mkdirSync(genDir, { recursive: true });
+    fs.writeFileSync(
+      path.join(genDir, `${GENERATED_ANDROID_CLASS}.kt`),
+      generatedAndroidContents(register),
+    );
+  }
+  // Register the app-owned screens dir (+ generated dir) as extra java
+  // srcDirs so their .kt files compile into the app.
+  config = withAppBuildGradle(config, (config) => {
+    const marker = "// react-native-evskit: app-owned glasses screens";
+    if (config.modResults.contents.includes(marker)) {
+      return config;
+    }
+    // Paths relative to <projectRoot>/android/app.
+    const appDir = path.join(projectRoot, "android", "app");
+    const srcDirs = [toPosix(path.relative(appDir, path.join(projectRoot, androidScreensDir)))];
+    if (Object.keys(register).length) {
+      srcDirs.push(
+        toPosix(path.relative(appDir, path.join(projectRoot, "android", GENERATED_ANDROID_DIR))),
+      );
+    }
+    const srcDirsList = srcDirs.map((d) => `                '${d}'`).join(",\n");
+    config.modResults.contents = config.modResults.contents.replace(
+      /android\s*\{/,
+      `android {\n${marker}\n    sourceSets {\n        main {\n            java.srcDirs += [\n${srcDirsList}\n            ]\n        }\n    }`,
+    );
+    return config;
+  });
+  return config;
+}

package/src/EvsKit.types.ts

@@ -95,6 +95,23 @@ export interface EvsQuaternionSample extends EvsSensorSample<EvsQuaternionData>
 
 export type EvsStockUIScreen = "configure" | "adjust" | "calibrate";
 
+// ---------------------------------------------------------------------------
+// App-owned screens (IEvsScreenService via EvsScreenRegistry)
+// ---------------------------------------------------------------------------
+
+/**
+ * String id of an app-owned native screen.
+ *
+ * The bridge ships no Screen subclasses. Each app registers its own
+ * Swift/Kotlin `Screen`/`FullScreen`/`ArScreen` subclasses via
+ * `EvsScreenRegistry.register(id, factory)` (iOS) /
+ * `EvsScreenRegistry.register(id, factory)` (Android) from app-owned
+ * sources — e.g. `<app>/evs-screens/ios/*.swift` linked at prebuild by the
+ * bridge config plugin's `screens` option — then pushes them with
+ * `EvsScreens.show(id)`.
+ */
+export type EvsScreenId = string;
+
 // ---------------------------------------------------------------------------
 // Auth (IEvsAuthService) / lifecycle events (IEvsAppEvents)
 // ---------------------------------------------------------------------------

package/src/EvsKitModule.ts

@@ -48,6 +48,20 @@ declare class EvsKitNativeModule extends NativeModule<EvsKitEvents> {
   setRenderingCenterX(dx: number): Promise<void>;
   setRenderingCenterY(dy: number): Promise<void>;
 
+  // --- App-owned screens (IEvsScreenService via EvsScreenRegistry) ------------
+  /**
+   * Push an app-registered screen onto the glasses screen stack.
+   * Rejects with EVSKIT_SHOW_SCREEN_FAILED / EVSKIT_UNKNOWN_SCREEN when no
+   * factory is registered for `id`.
+   */
+  showScreen(id: string): Promise<void>;
+  /** Remove a previously shown screen by id. No-op when unknown. */
+  removeScreen(id: string): Promise<void>;
+  /** Pop the topmost screen; resolves with its id, or null when empty/untracked. */
+  removeTopmostScreen(): Promise<string | null>;
+  /** Resolve the topmost tracked screen id, or null. */
+  getTopmostScreen(): Promise<string | null>;
+
   // --- Sensors (IEvsSensorsService) -------------------------------------------
   enableTouch(enabled: boolean): Promise<void>;
   enableAmbient(enabled: boolean): Promise<void>;

package/src/index.ts

@@ -6,6 +6,7 @@ import type {
   EvsDeviceInfo,
   EvsGlassesInfo,
   EvsKitEvents,
+  EvsScreenId,
   EvsStockUIScreen,
 } from "./EvsKit.types";
 import EvsKitNative from "./EvsKitModule";
@@ -120,6 +121,32 @@ export const EvsUI = {
   },
 };
 
+/**
+ * App-owned glasses screens (`Evs.instance().screens()`).
+ *
+ * The bridge ships no Screen subclasses. Register yours natively per app —
+ * `EvsScreenRegistry.register(id, factory)` from app-owned Swift/Kotlin
+ * sources (linked at prebuild by the plugin's `screens` option) — then push
+ * them from JS:
+ *
+ * @example
+ * await EvsScreens.show("hello-world");
+ */
+export const EvsScreens = {
+  show(id: EvsScreenId) {
+    return EvsKitNative.showScreen(id);
+  },
+  remove(id: EvsScreenId) {
+    return EvsKitNative.removeScreen(id);
+  },
+  removeTopmost() {
+    return EvsKitNative.removeTopmostScreen();
+  },
+  getTopmost() {
+    return EvsKitNative.getTopmostScreen();
+  },
+};
+
 /** Top-level lifecycle, matching `Evs.init(context).start()` / `Evs.instance().start()`. */
 export const EvsKit = {
   start() {
@@ -134,6 +161,7 @@ export const EvsKit = {
   sensors: EvsSensors,
   auth: EvsAuth,
   ui: EvsUI,
+  screens: EvsScreens,
 };
 
 export default EvsKit;