@mobileai/react-native 0.9.18 → 0.9.19

package/LICENSE

@@ -1,20 +1,28 @@
-MIT License
-
-Copyright (c) 2026 Mohamed Salah
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MobileAI Agent SDK License Agreement
+
+Copyright (c) 2026 Mohamed Salah. All rights reserved.
+
+END USER LICENSE AGREEMENT
+
+IMPORTANT - READ CAREFULLY: This End User License Agreement ("EULA") is a legal agreement between you (either an individual or a single entity) and Mohamed Salah ("Licensor") for the MobileAI Agent SDK software product, which includes computer software and may include associated media, printed materials, and "online" or electronic documentation ("SOFTWARE PRODUCT"). By installing, copying, or otherwise using the SOFTWARE PRODUCT, you agree to be bound by the terms of this EULA. If you do not agree to the terms of this EULA, do not install or use the SOFTWARE PRODUCT.
+
+1. GRANT OF LICENSE.
+Licensor grants you a non-exclusive, non-transferable, limited license to use the SOFTWARE PRODUCT solely for the purpose of integrating it into your application(s) that interconnect with the MobileAI online services, in accordance with the provided documentation and subject to your continued payment of applicable subscription or usage fees for the MobileAI services.
+
+2. RESTRICTIONS.
+- You may NOT modify, translate, reverse engineer, decompile, disassemble, or create derivative works based on the SOFTWARE PRODUCT.
+- You may NOT rent, lease, lend, sell, redistribute, or sublicense the SOFTWARE PRODUCT.
+- You may NOT use the SOFTWARE PRODUCT to develop a competitive service or product.
+- You may NOT remove any proprietary notices or labels on the SOFTWARE PRODUCT.
+
+3. COPYRIGHT.
+All title, including but not limited to copyrights, in and to the SOFTWARE PRODUCT and any copies thereof are owned by Licensor or its suppliers. All title and intellectual property rights in and to the content which may be accessed through use of the SOFTWARE PRODUCT is the property of the respective content owner and may be protected by applicable copyright or other intellectual property laws and treaties.
+
+4. TERMINATION.
+Without prejudice to any other rights, Licensor may terminate this EULA if you fail to comply with the terms and conditions of this EULA. In such event, you must destroy all copies of the SOFTWARE PRODUCT in your possession.
+
+5. NO WARRANTIES.
+The SOFTWARE PRODUCT is provided "as is" without warranty of any kind. Licensor disclaims all warranties, either express or implied, including the warranties of merchantability and fitness for a particular purpose.
+
+6. LIMITATION OF LIABILITY.
+In no event shall Licensor be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or any other pecuniary loss) arising out of the use of or inability to use this SOFTWARE PRODUCT.

package/MobileAIFloatingOverlay.podspec

@@ -0,0 +1,25 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name         = "MobileAIFloatingOverlay"
+  s.version      = package['version']
+  s.summary      = package['description']
+  s.homepage     = package['homepage'] || "https://github.com/mobileai"
+  s.license      = package['license']
+  s.authors      = package['author']
+
+  s.platforms    = { :ios => "13.0" }
+  s.source       = { :git => "https://github.com/mobileai/react-native-ai-agent.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/MobileAIFloatingOverlayComponentView.{h,m,mm,cpp}"
+
+  s.pod_target_xcconfig = {
+    "DEFINES_MODULE" => "NO",
+    "CLANG_CXX_LANGUAGE_STANDARD" => "c++20",
+    "OTHER_CPLUSPLUSFLAGS" => "-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1"
+  }
+
+  install_modules_dependencies(s)
+end

package/android/build.gradle

@@ -0,0 +1,61 @@
+buildscript {
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.1.0"
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.0"
+  }
+}
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+android {
+  compileSdkVersion 35
+  namespace "com.mobileai.overlay"
+
+  defaultConfig {
+    minSdkVersion 24
+    targetSdkVersion 35
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_17
+    targetCompatibility JavaVersion.VERSION_17
+  }
+
+  kotlinOptions {
+    jvmTarget = "17"
+  }
+
+  sourceSets {
+    main {
+      // Backward compatibility: conditionally load the correct ViewManager implementation.
+      // newArchEnabled=true  → Fabric (New Architecture, RN 0.74+)
+      // newArchEnabled=false → Paper (Old Architecture, <RN 0.74)
+      if (project.findProperty("newArchEnabled") == "true") {
+        java.srcDirs += ["src/newarch"]
+      } else {
+        java.srcDirs += ["src/oldarch"]
+      }
+    }
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,3 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+  package="com.mobileai.overlay">
+</manifest>

package/android/src/main/java/com/mobileai/overlay/FloatingOverlayView.kt

@@ -0,0 +1,151 @@
+package com.mobileai.overlay
+
+import android.app.Activity
+import android.app.Dialog
+import android.content.Context
+import android.graphics.Color
+import android.graphics.drawable.ColorDrawable
+import android.view.View
+import android.view.ViewGroup
+import android.view.WindowManager
+import android.widget.FrameLayout
+import com.facebook.react.bridge.ReactContext
+
+/**
+ * FloatingOverlayView — A ViewGroup that renders its children in an elevated
+ * Dialog window using WindowManager.LayoutParams.TYPE_APPLICATION_PANEL.
+ *
+ * Architecture:
+ * TYPE_APPLICATION_PANEL (z=1000) sits above normal app windows (TYPE_APPLICATION, z=2)
+ * AND above React Native's <Modal> Dialog windows (also TYPE_APPLICATION), because
+ * TYPE_APPLICATION_PANEL explicitly describes a panel that floats above its parent
+ * application window. No SYSTEM_ALERT_WINDOW permission required — the panel is
+ * scoped to the consuming app's own window hierarchy.
+ *
+ * Used by both Old Arch (FloatingOverlayViewManager) and New Arch Fabric implementations.
+ */
+class FloatingOverlayView(context: Context) : ViewGroup(context) {
+
+  private var overlayDialog: Dialog? = null
+
+  // All RN children are placed in this container inside the Dialog
+  private val contentContainer = FrameLayout(context)
+
+  // ─── Lifecycle ──────────────────────────────────────────────
+
+  override fun onAttachedToWindow() {
+    super.onAttachedToWindow()
+    showOverlay()
+  }
+
+  override fun onDetachedFromWindow() {
+    dismissOverlay()
+    super.onDetachedFromWindow()
+  }
+
+  // ─── Overlay management ──────────────────────────────────────
+
+  private fun showOverlay() {
+    val activity = getActivity() ?: return
+
+    overlayDialog = Dialog(activity, android.R.style.Theme_Translucent_NoTitleBar).also { dialog ->
+      dialog.window?.let { window ->
+        // TYPE_APPLICATION_PANEL: sub-window panel above its application window.
+        // Requires the parent window's token — no SYSTEM_ALERT_WINDOW needed.
+        window.setType(WindowManager.LayoutParams.TYPE_APPLICATION_PANEL)
+
+        // Anchor to the Activity's root decor view token.
+        // This makes our panel a child of the main window,
+        // floating above it and above any Dialogs (which are peers of the main window).
+        val attrs = window.attributes
+        attrs.token = activity.window.decorView.windowToken
+        window.attributes = attrs
+
+        window.setLayout(
+          ViewGroup.LayoutParams.MATCH_PARENT,
+          ViewGroup.LayoutParams.MATCH_PARENT
+        )
+        window.setBackgroundDrawable(ColorDrawable(Color.TRANSPARENT))
+
+        // FLAG_NOT_FOCUSABLE: don't steal keyboard focus from the underlying app.
+        // Keyboard inputs (TextInput in the chat bar) still work because
+        // the chat bar's own TextInput will request focus explicitly when tapped.
+        window.addFlags(WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE)
+
+        // FLAG_NOT_TOUCH_MODAL: allow touches outside our visible UI to reach the
+        // underlying app / dialog windows. Without this, any touch on the transparent
+        // areas of our overlay would be consumed and swallowed.
+        window.addFlags(WindowManager.LayoutParams.FLAG_NOT_TOUCH_MODAL)
+
+        window.addFlags(WindowManager.LayoutParams.FLAG_HARDWARE_ACCELERATED)
+      }
+
+      dialog.setContentView(contentContainer)
+      dialog.setCanceledOnTouchOutside(false)
+      dialog.show()
+    }
+  }
+
+  private fun dismissOverlay() {
+    try {
+      if (overlayDialog?.isShowing == true) {
+        overlayDialog?.dismiss()
+      }
+    } catch (e: Exception) {
+      // Activity may already be finishing — safe to ignore crash
+    } finally {
+      overlayDialog = null
+    }
+  }
+
+  // ─── Child view forwarding ───────────────────────────────────
+  // React Native's layout engine sees THIS ViewGroup, but actual rendering
+  // happens in the Dialog's contentContainer.
+  // We forward all child management calls to maintain RN's expectations.
+
+  override fun addView(child: View) {
+    contentContainer.addView(child)
+  }
+
+  override fun addView(child: View, index: Int) {
+    contentContainer.addView(child, index)
+  }
+
+  override fun addView(child: View, params: ViewGroup.LayoutParams) {
+    contentContainer.addView(child, params)
+  }
+
+  override fun addView(child: View, index: Int, params: ViewGroup.LayoutParams) {
+    contentContainer.addView(child, index, params)
+  }
+
+  override fun removeView(view: View) {
+    contentContainer.removeView(view)
+  }
+
+  override fun removeViewAt(index: Int) {
+    contentContainer.removeViewAt(index)
+  }
+
+  override fun getChildCount(): Int = contentContainer.childCount
+
+  override fun getChildAt(index: Int): View? = contentContainer.getChildAt(index)
+
+  // ─── Layout ──────────────────────────────────────────────────
+
+  // The Dialog manages sizing (MATCH_PARENT) — this View itself is invisible
+  // in the main window and only serves as an anchor.
+  override fun onLayout(changed: Boolean, l: Int, t: Int, r: Int, b: Int) { /* no-op */ }
+
+  override fun onMeasure(widthMeasureSpec: Int, heightMeasureSpec: Int) {
+    super.onMeasure(widthMeasureSpec, heightMeasureSpec)
+  }
+
+  // ─── Helpers ─────────────────────────────────────────────────
+
+  private fun getActivity(): Activity? {
+    // ReactContext knows the current Activity
+    return (context as? ReactContext)?.currentActivity
+      ?: (context as? Activity)
+  }
+}

package/android/src/main/java/com/mobileai/overlay/MobileAIOverlayPackage.kt

@@ -0,0 +1,23 @@
+package com.mobileai.overlay
+
+import com.facebook.react.ReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.uimanager.ViewManager
+
+/**
+ * MobileAIOverlayPackage — registers the FloatingOverlayViewManager with React Native.
+ *
+ * Auto-linked by React Native's auto-linking system via react-native.config.js.
+ * Consumers do NOT need to manually add this package to their MainApplication.
+ */
+class MobileAIOverlayPackage : ReactPackage {
+
+  override fun createNativeModules(reactContext: ReactApplicationContext): List<NativeModule> {
+    return emptyList()
+  }
+
+  override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
+    return listOf(FloatingOverlayViewManager(reactContext))
+  }
+}

package/android/src/newarch/com/mobileai/overlay/FloatingOverlayViewManager.kt

@@ -0,0 +1,45 @@
+package com.mobileai.overlay
+
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.uimanager.SimpleViewManager
+import com.facebook.react.uimanager.ThemedReactContext
+import com.facebook.react.uimanager.ViewManagerDelegate
+import com.facebook.react.uimanager.annotations.ReactProp
+
+/**
+ * New Architecture (Fabric) ViewManager for MobileAIFloatingOverlay.
+ *
+ * Used when newArchEnabled=true in the consuming app's gradle.properties.
+ * Loaded via the newarch/ sourceSet in build.gradle.
+ *
+ * Codegen generates FloatingOverlayNativeComponentSpec from src/specs/FloatingOverlayNativeComponent.ts.
+ * This class implements the generated spec interface for Fabric rendering.
+ */
+class FloatingOverlayViewManager(
+  private val reactApplicationContext: ReactApplicationContext
+) : SimpleViewManager<FloatingOverlayView>() {
+
+  // Fabric: delegate is generated by Codegen. Null until Codegen runs.
+  // The interop layer uses this delegate to bridge JS<->Native in New Arch.
+  private val delegate: ViewManagerDelegate<FloatingOverlayView>? = try {
+    // Codegen generates this class during the build. It may not exist yet in dev setups.
+    Class.forName("com.mobileai.overlay.FloatingOverlayNativeComponentSpecDelegate")
+      .getConstructor(SimpleViewManager::class.java)
+      .newInstance(this) as? ViewManagerDelegate<FloatingOverlayView>
+  } catch (e: Exception) {
+    // Codegen hasn't run yet or interop is disabled — proceed without delegate
+    null
+  }
+
+  override fun getDelegate(): ViewManagerDelegate<FloatingOverlayView>? = delegate
+
+  override fun getName(): String = NAME
+
+  override fun createViewInstance(context: ThemedReactContext): FloatingOverlayView {
+    return FloatingOverlayView(context)
+  }
+
+  companion object {
+    const val NAME = "MobileAIFloatingOverlay"
+  }
+}

package/android/src/oldarch/com/mobileai/overlay/FloatingOverlayViewManager.kt

@@ -0,0 +1,29 @@
+package com.mobileai.overlay
+
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.uimanager.SimpleViewManager
+import com.facebook.react.uimanager.ThemedReactContext
+
+/**
+ * Old Architecture (Paper) ViewManager for MobileAIFloatingOverlay.
+ *
+ * Used when newArchEnabled=false in the consuming app's gradle.properties.
+ * Loaded via the oldarch/ sourceSet in build.gradle.
+ *
+ * Consumers don't interact with this class — it's registered automatically via
+ * MobileAIOverlayPackage and the React Native auto-linking system.
+ */
+class FloatingOverlayViewManager(
+  private val reactApplicationContext: ReactApplicationContext
+) : SimpleViewManager<FloatingOverlayView>() {
+
+  override fun getName(): String = NAME
+
+  override fun createViewInstance(context: ThemedReactContext): FloatingOverlayView {
+    return FloatingOverlayView(context)
+  }
+
+  companion object {
+    const val NAME = "MobileAIFloatingOverlay"
+  }
+}

package/ios/MobileAIFloatingOverlayComponentView.mm

@@ -0,0 +1,73 @@
+#import <React/RCTViewComponentView.h>
+#import <UIKit/UIKit.h>
+
+#import <react/renderer/components/RNMobileAIOverlaySpec/ComponentDescriptors.h>
+#import <react/renderer/components/RNMobileAIOverlaySpec/EventEmitters.h>
+#import <react/renderer/components/RNMobileAIOverlaySpec/Props.h>
+#import <react/renderer/components/RNMobileAIOverlaySpec/RCTComponentViewHelpers.h>
+
+#import "RCTFabricComponentsPlugins.h"
+
+NS_ASSUME_NONNULL_BEGIN
+@interface MobileAIFloatingOverlayComponentView : RCTViewComponentView
+@end
+NS_ASSUME_NONNULL_END
+
+using namespace facebook::react;
+
+@interface MobileAIFloatingOverlayComponentView () <RCTMobileAIFloatingOverlayViewProtocol>
+@end
+
+@implementation MobileAIFloatingOverlayComponentView {
+    UIView * _view;
+}
+
++ (ComponentDescriptorProvider)componentDescriptorProvider
+{
+    return concreteComponentDescriptorProvider<MobileAIFloatingOverlayComponentDescriptor>();
+}
+
+- (instancetype)initWithFrame:(CGRect)frame
+{
+  if (self = [super initWithFrame:frame]) {
+    static const auto defaultProps = std::make_shared<const MobileAIFloatingOverlayProps>();
+    _props = defaultProps;
+
+    _view = [[UIView alloc] init];
+
+    self.contentView = _view;
+  }
+
+  return self;
+}
+
+- (void)updateProps:(Props::Shared const &)props oldProps:(Props::Shared const &)oldProps
+{
+    const auto &oldViewProps = *std::static_pointer_cast<MobileAIFloatingOverlayProps const>(_props);
+    const auto &newViewProps = *std::static_pointer_cast<MobileAIFloatingOverlayProps const>(props);
+
+    [super updateProps:props oldProps:oldProps];
+}
+
+@end
+
+Class<RCTComponentViewProtocol> MobileAIFloatingOverlayCls(void)
+{
+  return MobileAIFloatingOverlayComponentView.class;
+}
+
+// ─── Linker Fix: Force inclusion of the library ────────────────
+
+#import <React/RCTViewManager.h>
+
+@interface MobileAIFloatingOverlayManager : RCTViewManager
+@end
+
+@implementation MobileAIFloatingOverlayManager
+RCT_EXPORT_MODULE(MobileAIFloatingOverlay)
+
+- (UIView *)view
+{
+  return [[UIView alloc] init];
+}
+@end