@octopus-community/react-native 1.0.6 → 1.0.8

package/README.md

@@ -115,7 +115,7 @@ await initialize({
       onPrimary: '#FFFFFF', // Text color on primary background
     },
     logo: {
-      image: Image.resolveAssetSource(require('./assets/logo.png')), // Your custom logo
+      image: Image.resolveAssetSource(require('./assets/images/logo.png')), // Your custom logo
     },
   }
 });
@@ -186,7 +186,7 @@ await initialize({
       onPrimary: '#FFFFFF', // Text color on primary background
     },
     logo: {
-      image: Image.resolveAssetSource(require('./assets/logo.png')),
+      image: Image.resolveAssetSource(require('./assets/images/logo.png')),
     },
   }
 });
@@ -351,7 +351,7 @@ await initialize({
     },
     // Custom logo
     logo: {
-      image: Image.resolveAssetSource(require('./assets/logo.png')),
+      image: Image.resolveAssetSource(require('./assets/images/logo.png')),
     },
   }
 });
@@ -408,7 +408,7 @@ const switchToGreenTheme = async () => {
 - `caption1`: Small captions (default: 12pt)
 - `caption2`: Extra small captions (default: 10pt)
 
-   
+
 
 **Supported Formats:**
 - **Colors**: 3-digit (`#F63`), 6-digit (`#FF6633`), 8-digit (`#FF6633FF`) hex codes

package/android/src/main/java/com/octopuscommunity/octopusreactnativesdk/OctopusReactNativeSdkModule.kt

@@ -12,7 +12,7 @@ class OctopusReactNativeSdkModule(reactContext: ReactApplicationContext) :
   private val sdkInitializer = OctopusSDKInitializer()
   private val eventEmitter = OctopusEventEmitter(reactContext)
   private val uiController = OctopusUIController(reactContext)
-  private val ssoAuthenticator = OctopusSSOAuthenticator(eventEmitter)
+  private val ssoAuthenticator = OctopusSSOAuthenticator(reactContext, eventEmitter)
 
   override fun getName(): String = NAME
 
@@ -85,10 +85,10 @@ class OctopusReactNativeSdkModule(reactContext: ReactApplicationContext) :
       promise.reject("UPDATE_THEME_ERROR", "Failed to update theme", e)
     }
   }
-  
+
   private fun parseColor(colorString: String?): String? {
     if (colorString == null) return null
-    
+
     return try {
       // Validate that the color string is a valid hex color
       android.graphics.Color.parseColor(colorString)
@@ -99,31 +99,31 @@ class OctopusReactNativeSdkModule(reactContext: ReactApplicationContext) :
       null
     }
   }
-  
+
   private fun parseFontsConfig(fontsMap: ReadableMap): OctopusFontsConfig? {
     // Use pre-processed configuration from TypeScript layer
     val parsedConfig = fontsMap.getMap("parsedConfig")
     if (parsedConfig != null) {
       return parsePreProcessedFontsConfig(parsedConfig)
     }
-    
+
     return null
   }
-  
+
   private fun parsePreProcessedFontsConfig(parsedConfig: ReadableMap): OctopusFontsConfig? {
     val textStylesMap = parsedConfig.getMap("textStyles")
     val textStyles = mutableMapOf<String, OctopusTextStyleConfig>()
-    
+
     // Parse pre-processed font configuration from TypeScript layer
     textStylesMap?.let { textStylesMap ->
       val textStyleKeys = arrayOf("title1", "title2", "body1", "body2", "caption1", "caption2")
-      
+
       textStyleKeys.forEach { key ->
         val textStyleMap = textStylesMap.getMap(key)
         textStyleMap?.let { style ->
           val fontType = style.getString("fontType")
           val fontSize = if (style.hasKey("fontSize")) style.getDouble("fontSize") else Double.NaN
-          
+
           if (fontType != null || (!fontSize.isNaN() && fontSize > 0)) {
             textStyles[key] = OctopusTextStyleConfig(
               fontType = fontType,
@@ -133,14 +133,14 @@ class OctopusReactNativeSdkModule(reactContext: ReactApplicationContext) :
         }
       }
     }
-    
+
     // Only create fonts config if we have text styles
     if (textStyles.isNotEmpty()) {
       return OctopusFontsConfig(
         textStyles = textStyles
       )
     }
-    
+
     return null
   }
 

package/android/src/main/java/com/octopuscommunity/octopusreactnativesdk/OctopusSDKInitializer.kt

@@ -18,11 +18,15 @@ class OctopusSDKInitializer {
 
     try {
       val connectionMode = parseConnectionMode(options)
-      
+
       // Store theme configuration for later use in UI
       val themeConfig = parseThemeConfig(options)
       OctopusThemeManager.setThemeConfig(themeConfig)
-      
+
+      // Store UI configuration separately
+      val uiConfiguration = parseUIConfiguration(options)
+      OctopusUIConfigurationManager.setUIConfiguration(uiConfiguration)
+
       OctopusSDK.initialize(
         context = context,
         apiKey = apiKey,
@@ -35,19 +39,19 @@ class OctopusSDKInitializer {
       promise.reject("INITIALIZE_ERROR", "Failed to initialize Octopus SDK", e)
     }
   }
-  
+
   fun parseThemeConfig(options: ReadableMap): OctopusThemeConfig? {
-    
+
     val themeMap = options.getMap("theme")
     val colorScheme = options.getString("colorScheme") // Get colorScheme from React Native
-    
+
     var primaryColor: String? = null
     var primaryLowContrastColor: String? = null
     var primaryHighContrastColor: String? = null
     var onPrimaryColor: String? = null
     var logoSource: ReadableMap? = null
     var fontsConfig: OctopusFontsConfig? = null
-    
+
     // Parse colors from theme if available
     themeMap?.let { theme ->
       val colorsMap = theme.getMap("colors")
@@ -55,7 +59,7 @@ class OctopusSDKInitializer {
         // Check if this is a dual-mode theme (has light and dark properties)
         val lightColors = colors.getMap("light")
         val darkColors = colors.getMap("dark")
-        
+
         if (lightColors != null && darkColors != null) {
           // Dual-mode theme - select colors based on current color scheme
           val selectedColors = if (colorScheme == "dark") darkColors else lightColors
@@ -71,7 +75,7 @@ class OctopusSDKInitializer {
           onPrimaryColor = parseColor(if (colors.hasKey("onPrimary")) colors.getString("onPrimary") else null)
         }
       }
-      
+
       // Handle logo from theme
       val logoMap = theme.getMap("logo")
       logoMap?.let { logo ->
@@ -80,7 +84,7 @@ class OctopusSDKInitializer {
           logoSource = imageSource
         }
       }
-      
+
       // Handle fonts from theme - use pre-processed configuration from TypeScript layer
       val fontsMap = theme.getMap("fonts")
       fontsMap?.let { fonts ->
@@ -90,7 +94,7 @@ class OctopusSDKInitializer {
         }
       }
     }
-    
+
     // Handle logo at root level (for backward compatibility)
     if (logoSource == null) {
       val rootLogoMap = options.getMap("logo")
@@ -101,7 +105,7 @@ class OctopusSDKInitializer {
         }
       }
     }
-    
+
     // Only create theme config if we have at least one customization
     if (primaryColor != null || logoSource != null || colorScheme != null || fontsConfig != null) {
       return OctopusThemeConfig(
@@ -114,24 +118,51 @@ class OctopusSDKInitializer {
         fonts = fontsConfig
       )
     }
-    
+
     return null
   }
-  
+
+  fun parseUIConfiguration(options: ReadableMap): OctopusUIConfiguration? {
+    val uiMap = options.getMap("ui")
+    var bottomContentPadding: Double? = null
+
+    uiMap?.let { uiOptions ->
+      val candidateKeys = listOf("bottomSafeAreaInset", "bottomPadding", "contentPadding", "contentPaddingBottom")
+      for (key in candidateKeys) {
+        if (uiOptions.hasKey(key)) {
+          bottomContentPadding = try {
+            uiOptions.getDouble(key).coerceAtLeast(0.0)
+          } catch (e: Exception) {
+            null
+          }
+          if (bottomContentPadding != null) {
+            break
+          }
+        }
+      }
+    }
+
+    return if (bottomContentPadding != null) {
+      OctopusUIConfiguration(bottomContentPadding = bottomContentPadding)
+    } else {
+      null
+    }
+  }
+
   private fun parsePreProcessedFontsConfig(parsedConfig: ReadableMap): OctopusFontsConfig? {
     val textStylesMap = parsedConfig.getMap("textStyles")
     val textStyles = mutableMapOf<String, OctopusTextStyleConfig>()
-    
+
     // Parse pre-processed font configuration from TypeScript layer
     textStylesMap?.let { textStylesMap ->
       val textStyleKeys = arrayOf("title1", "title2", "body1", "body2", "caption1", "caption2")
-      
+
       textStyleKeys.forEach { key ->
         val textStyleMap = textStylesMap.getMap(key)
         textStyleMap?.let { style ->
           val fontType = style.getString("fontType")
           val fontSize = if (style.hasKey("fontSize")) style.getDouble("fontSize") else Double.NaN
-          
+
           if (fontType != null || (!fontSize.isNaN() && fontSize > 0)) {
             textStyles[key] = OctopusTextStyleConfig(
               fontType = fontType,
@@ -141,18 +172,18 @@ class OctopusSDKInitializer {
         }
       }
     }
-    
+
     // Only create fonts config if we have text styles
     if (textStyles.isNotEmpty()) {
       return OctopusFontsConfig(
         textStyles = textStyles
       )
     }
-    
+
     return null
   }
 
-  
+
   private fun extractResourceNameFromUri(uri: String): String? {
     // Extract resource name from React Native image URI
     // Examples: "logo.png" -> "logo", "images/logo.png" -> "logo"
@@ -163,10 +194,10 @@ class OctopusSDKInitializer {
       null
     }
   }
-  
+
   private fun parseColor(colorString: String?): String? {
     if (colorString == null) return null
-    
+
     return try {
       // Validate that the color string is a valid hex color
       Color.parseColor(colorString)

package/android/src/main/java/com/octopuscommunity/octopusreactnativesdk/OctopusSSOAuthenticator.kt

@@ -15,8 +15,13 @@ import java.util.UUID
 import java.util.concurrent.ConcurrentHashMap
 import kotlin.coroutines.resume
 import kotlin.coroutines.resumeWithException
+import android.content.Context
 
-class OctopusSSOAuthenticator(private val eventEmitter: OctopusEventEmitter) {
+
+class OctopusSSOAuthenticator(
+  private val context: Context,
+  private val eventEmitter: OctopusEventEmitter
+ ) {
 
   private val coroutineScope = CoroutineScope(Dispatchers.Main)
   private val pendingTokenRequests =
@@ -107,10 +112,22 @@ class OctopusSSOAuthenticator(private val eventEmitter: OctopusEventEmitter) {
     } else null
 
     val profilePicture = profileParams.getString("profilePicture")?.let { pictureUrl ->
-      if (pictureUrl.isNotBlank() && (pictureUrl.startsWith("http://") || pictureUrl.startsWith("https://"))) {
+      if (pictureUrl.startsWith("http://") || pictureUrl.startsWith("https://")) {
         Image.Remote(pictureUrl)
-      } else if (pictureUrl.isNotBlank()) {
+      } else if (pictureUrl.startsWith("file") || pictureUrl.startsWith("android.resource")) {
         Image.Local(pictureUrl)
+      } else if(pictureUrl.isNotBlank()) {
+        // Asset names like "assets_images_logo" need conversion
+        // Convert to drawable resource URI
+        val resourceId = context.resources.getIdentifier(pictureUrl, "drawable", context.packageName)
+        Image.Local(
+          if (resourceId != 0) {
+            "android.resource://${context.packageName}/$resourceId"
+          } else {
+            // Fallback: try assets folder
+            "file:///android_asset/$pictureUrl"
+          }
+        )
       } else {
         null
       }

package/android/src/main/java/com/octopuscommunity/octopusreactnativesdk/OctopusUIActivity.kt

@@ -12,7 +12,9 @@ import android.util.Log
 import androidx.activity.ComponentActivity
 import androidx.activity.compose.setContent
 import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.PaddingValues
 import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.foundation.layout.padding
 import androidx.compose.runtime.Composable
 import androidx.compose.runtime.LaunchedEffect
 import androidx.compose.runtime.getValue
@@ -20,6 +22,7 @@ import androidx.compose.runtime.mutableStateOf
 import androidx.compose.runtime.remember
 import androidx.compose.runtime.setValue
 import androidx.compose.ui.Modifier
+import androidx.compose.ui.unit.Dp
 import androidx.compose.ui.graphics.Color
 import androidx.compose.ui.graphics.asImageBitmap
 import androidx.compose.ui.graphics.painter.BitmapPainter
@@ -32,11 +35,13 @@ import com.octopuscommunity.sdk.ui.OctopusDrawablesDefaults
 import com.octopuscommunity.sdk.ui.OctopusTheme
 import com.octopuscommunity.sdk.ui.OctopusTypographyDefaults
 import com.octopuscommunity.sdk.ui.OctopusTypography
+import com.octopuscommunity.sdk.ui.home.OctopusHomeDefaults
 import com.octopuscommunity.sdk.ui.components.OctopusNavigationHandler
 import androidx.compose.ui.text.TextStyle
 import androidx.compose.ui.text.font.FontFamily
 import androidx.compose.ui.text.font.FontWeight
 import androidx.compose.ui.unit.sp
+import androidx.compose.ui.unit.dp
 import com.octopuscommunity.sdk.ui.home.OctopusHomeScreen
 import com.octopuscommunity.sdk.ui.octopusComposables
 import com.octopuscommunity.sdk.ui.octopusDarkColorScheme
@@ -151,14 +156,18 @@ private fun OctopusUI(onBack: () -> Unit) {
 
     // Create typography based on theme config
     val typography = createCustomTypography(themeConfig)
+    val uiConfiguration = OctopusUIConfigurationManager.getUIConfiguration()
 
-    // Apply theme with custom colors, logo, and typography
+    // Apply theme with custom colors, logo, typography, and content padding
     OctopusTheme(
         colorScheme = finalColorScheme,
         drawables = drawables,
         typography = typography
     ) {
-        OctopusUIContent(onBack = onBack)
+        OctopusUIContent(
+          bottomContentPadding = uiConfiguration?.bottomContentPadding?.toFloat()?.dp,
+          onBack = onBack
+        )
     }
 }
 
@@ -213,7 +222,7 @@ private fun createTextStyle(textStyleConfig: OctopusTextStyleConfig?, defaultSty
 
 
 @Composable
-private fun OctopusUIContent(onBack: () -> Unit) {
+private fun OctopusUIContent(bottomContentPadding: Dp?, onBack: () -> Unit) {
     Box(modifier = Modifier.fillMaxSize()) {
         val navController = rememberNavController()
 
@@ -222,23 +231,26 @@ private fun OctopusUIContent(onBack: () -> Unit) {
             startDestination = "OctopusHome"
         ) {
             composable(route = "OctopusHome") {
-                OctopusNavigationHandler(
-                    navigateToLogin = {
-                        OctopusEventEmitter.instance?.emitLoginRequired()
-                    },
-                    navigateToProfileEdit = { fieldToEdit ->
-                        OctopusEventEmitter.instance?.emitEditUser(fieldToEdit)
-                    },
-                    navigateToClientObject = {
-                        // TODO : Bridge Post react
-                    }
-                ) {
-                    OctopusHomeScreen(
-                        navController = navController,
-                        backIcon = true,
-                        onBack = onBack
-                    )
+              OctopusNavigationHandler(
+                navigateToLogin = {
+                  OctopusEventEmitter.instance?.emitLoginRequired()
+                },
+                navigateToProfileEdit = { fieldToEdit ->
+                  OctopusEventEmitter.instance?.emitEditUser(fieldToEdit)
+                },
+                navigateToClientObject = {
+                  // TODO : Bridge Post react
                 }
+              ) {
+                OctopusHomeScreen(
+                  navController = navController,
+                  backIcon = true,
+                  floatingActionsPadding = OctopusHomeDefaults.floatingActionsPadding(
+                    bottom = bottomContentPadding ?: 16.dp
+                  ),
+                  onBack = onBack
+                )
+              }
             }
             octopusComposables(
                 navController = navController,

package/android/src/main/java/com/octopuscommunity/octopusreactnativesdk/OctopusUIConfiguration.kt

@@ -0,0 +1,6 @@
+package com.octopuscommunity.octopusreactnativesdk
+
+data class OctopusUIConfiguration(
+  val bottomContentPadding: Double?
+)
+

package/android/src/main/java/com/octopuscommunity/octopusreactnativesdk/OctopusUIConfigurationManager.kt

@@ -0,0 +1,12 @@
+package com.octopuscommunity.octopusreactnativesdk
+
+object OctopusUIConfigurationManager {
+  private var uiConfiguration: OctopusUIConfiguration? = null
+  
+  fun setUIConfiguration(config: OctopusUIConfiguration?) {
+    uiConfiguration = config
+  }
+  
+  fun getUIConfiguration(): OctopusUIConfiguration? = uiConfiguration
+}
+

package/ios/OctopusReactNativeSdk.swift

@@ -17,6 +17,7 @@ class OctopusReactNativeSdk: NSObject, RCTBridgeModule {
   private var theme: OctopusTheme?
   private var logoSource: [String: Any]?
   private var fontConfiguration: [String: Any]?
+  private var uiConfiguration: OctopusUIConfiguration?
   
   // MARK: - RCTBridgeModule
   
@@ -40,6 +41,7 @@ class OctopusReactNativeSdk: NSObject, RCTBridgeModule {
       self.theme = sdkInitializer.parseTheme(from: options)
       self.logoSource = sdkInitializer.getLogoSource(from: options)
       self.fontConfiguration = sdkInitializer.getFontConfiguration(from: options)
+      self.uiConfiguration = sdkInitializer.parseUIConfiguration(from: options)
       resolve(nil)
     } catch {
       reject("INITIALIZE_ERROR", "Failed to initialize Octopus SDK: \(error.localizedDescription)", error)
@@ -115,7 +117,13 @@ class OctopusReactNativeSdk: NSObject, RCTBridgeModule {
 
     DispatchQueue.main.async {
       do {
-        try self.uiManager.openUI(octopus: octopus, theme: self.theme, logoSource: self.logoSource, fontConfiguration: self.fontConfiguration)
+        try self.uiManager.openUI(
+          octopus: octopus,
+          theme: self.theme,
+          logoSource: self.logoSource,
+          fontConfiguration: self.fontConfiguration,
+          uiConfiguration: self.uiConfiguration
+        )
         resolve(nil)
       } catch {
         reject("OPEN_UI_ERROR", error.localizedDescription, error)

package/ios/OctopusSDKInitializer.swift

@@ -1,6 +1,7 @@
 import Octopus
 import OctopusUI
 import SwiftUI
+import CoreGraphics
 
 class OctopusSDKInitializer {
   func initialize(options: [String: Any], eventManager: OctopusEventManager) throws -> OctopusSDK {
@@ -144,6 +145,37 @@ class OctopusSDKInitializer {
     return nil
   }
 
+  func parseUIConfiguration(from options: [String: Any]) -> OctopusUIConfiguration? {
+    guard let uiOptions = options["ui"] as? [String: Any] else {
+      return nil
+    }
+
+    let supportedKeys = [
+      "bottomSafeAreaInset",
+      "bottomPadding",
+      "contentPadding",
+      "contentPaddingBottom",
+    ]
+
+    var bottomInset: CGFloat?
+
+    for key in supportedKeys {
+      if let value = uiOptions[key] as? NSNumber {
+        bottomInset = CGFloat(truncating: value)
+        break
+      } else if let value = uiOptions[key] as? Double {
+        bottomInset = CGFloat(value)
+        break
+      }
+    }
+
+    guard let finalInset = bottomInset else {
+      return nil
+    }
+
+    return OctopusUIConfiguration(bottomSafeAreaInset: max(0, finalInset))
+  }
+
   private func parseConnectionMode(from connectionModeMap: [String: Any], eventManager: OctopusEventManager) throws -> ConnectionMode {
     let connectionModeType = connectionModeMap["type"] as? String
 

package/ios/OctopusUIConfiguration.swift

@@ -0,0 +1,6 @@
+import CoreGraphics
+
+struct OctopusUIConfiguration {
+  let bottomSafeAreaInset: CGFloat?
+}
+

package/ios/OctopusUIManager.swift

@@ -7,24 +7,35 @@ import React
 class OctopusUIManager {
   private weak var presentedViewController: UIViewController?
 
-  func openUI(octopus: OctopusSDK, theme: OctopusUI.OctopusTheme?, logoSource: [String: Any]?, fontConfiguration: [String: Any]?) throws {
+  func openUI(
+    octopus: OctopusSDK,
+    theme: OctopusUI.OctopusTheme?,
+    logoSource: [String: Any]?,
+    fontConfiguration: [String: Any]?,
+    uiConfiguration: OctopusUIConfiguration?
+  ) throws {
     guard let presentingViewController = RCTPresentedViewController() else {
       throw NSError(domain: "OPEN_UI_ERROR", code: 0, userInfo: [NSLocalizedDescriptionKey: "Could not find presenting view controller"])
     }
 
     // Create custom theme with font configuration
     let customTheme = createCustomTheme(baseTheme: theme, fontConfiguration: fontConfiguration)
-    
-    let octopusHomeScreen = OctopusHomeScreen(octopus: octopus)
-      .environment(\.octopusTheme, customTheme)
-    
-    let hostingController = UIHostingController(rootView: AnyView(octopusHomeScreen))
-    hostingController.modalPresentationStyle = .fullScreen
+    let bottomSafeAreaInset = uiConfiguration?.bottomSafeAreaInset
+    let initialTheme = (theme != nil || fontConfiguration != nil) ? customTheme : nil
 
+    let hostingController = UIHostingController(
+      rootView: makeHomeScreenView(octopus: octopus, theme: initialTheme, bottomSafeAreaInset: bottomSafeAreaInset)
+    )
+    hostingController.modalPresentationStyle = .fullScreen
+    
     // Apply theme if provided
     if let _ = theme {
       // Apply theme immediately (without logo) to avoid delay
-      hostingController.rootView = AnyView(OctopusHomeScreen(octopus: octopus).environment(\.octopusTheme, customTheme))
+      hostingController.rootView = makeHomeScreenView(
+        octopus: octopus,
+        theme: customTheme,
+        bottomSafeAreaInset: bottomSafeAreaInset
+      )
       
       // Then load logo asynchronously and update theme if logo loads
       if let logoSource = logoSource {
@@ -36,7 +47,11 @@ class OctopusUIManager {
                 fonts: customTheme.fonts,
                 assets: OctopusUI.OctopusTheme.Assets(logo: logoImage)
               )
-              hostingController?.rootView = AnyView(OctopusHomeScreen(octopus: octopus).environment(\.octopusTheme, updatedTheme))
+              hostingController?.rootView = self.makeHomeScreenView(
+                octopus: octopus,
+                theme: updatedTheme,
+                bottomSafeAreaInset: bottomSafeAreaInset
+              )
             } else {
               // Theme is already applied, no need to do anything
             }
@@ -53,7 +68,11 @@ class OctopusUIManager {
               fonts: OctopusUI.OctopusTheme.Fonts(),
               assets: OctopusUI.OctopusTheme.Assets(logo: logoImage)
             )
-            hostingController?.rootView = AnyView(OctopusHomeScreen(octopus: octopus).environment(\.octopusTheme, logoTheme))
+            hostingController?.rootView = self.makeHomeScreenView(
+              octopus: octopus,
+              theme: logoTheme,
+              bottomSafeAreaInset: bottomSafeAreaInset
+            )
           }
         }
       }
@@ -142,6 +161,28 @@ class OctopusUIManager {
       presentedViewController = nil
     }
   }
+
+  private func makeHomeScreenView(octopus: OctopusSDK, theme: OctopusUI.OctopusTheme?, bottomSafeAreaInset: CGFloat?) -> AnyView {
+    if let inset = bottomSafeAreaInset {
+      if let theme = theme {
+        return AnyView(
+          OctopusHomeScreen(octopus: octopus, bottomSafeAreaInset: inset)
+            .environment(\.octopusTheme, theme)
+        )
+      }
+
+      return AnyView(OctopusHomeScreen(octopus: octopus, bottomSafeAreaInset: inset))
+    }
+
+    if let theme = theme {
+      return AnyView(
+        OctopusHomeScreen(octopus: octopus)
+          .environment(\.octopusTheme, theme)
+      )
+    }
+
+    return AnyView(OctopusHomeScreen(octopus: octopus))
+  }
   
   private func createCustomTheme(baseTheme: OctopusUI.OctopusTheme?, fontConfiguration: [String: Any]?) -> OctopusUI.OctopusTheme {
     // If no font configuration, return the base theme or default

package/lib/module/initialize.js

@@ -33,6 +33,10 @@ import { parseFontConfig } from "./internals/fontParser.js";
  * 2. Dual mode colors - separate color sets for light and dark modes
  */
 
+/**
+ * UI customization options for platform-specific layout adjustments.
+ */
+
 /**
  * Configuration params for initializing the Octopus SDK.
  */

package/lib/module/initialize.js.map

@@ -1 +1 @@
-{"version":3,"names":["OctopusReactNativeSdk","Appearance","colorSchemeManager","parseFontConfig","initialize","params","colorScheme","getColorScheme","processedTheme","theme","fonts","parsedConfig","undefined","paramsWithColorScheme","setTheme","startListening"],"sourceRoot":"../../src","sources":["initialize.ts"],"mappings":";;AAAA,SAASA,qBAAqB,QAAQ,6BAA0B;AAGhE,SAASC,UAAU,QAAQ,cAAc;AACzC,SAASC,kBAAkB,QAAQ,mCAAgC;AACnE,SAASC,eAAe,QAA+B,2BAAwB;;AAE/E;AACA;AACA;;AAYA;AACA;AACA;;AAGA;AACA;AACA;;AAMA;AACA;AACA;;AAQA;AACA;AACA;;AA0BA;AACA;AACA;AACA;AACA;AACA;AACA;;AAyBA;AACA;AACA;;AAwBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAACC,MAAwB,EAAiB;EAClE;EACA,MAAMC,WAAW,GAAGL,UAAU,CAACM,cAAc,CAAC,CAAC;;EAE/C;EACA,MAAMC,cAAc,GAAGH,MAAM,CAACI,KAAK,GAC/B;IACE,GAAGJ,MAAM,CAACI,KAAK;IACfC,KAAK,EAAEL,MAAM,CAACI,KAAK,CAACC,KAAK,GACrB;MACE,GAAGL,MAAM,CAACI,KAAK,CAACC,KAAK;MACrBC,YAAY,EAAER,eAAe,CAACE,MAAM,CAACI,KAAK,CAACC,KAAK;IAClD,CAAC,GACDE;EACN,CAAC,GACDA,SAAS;EAEb,MAAMC,qBAAqB,GAAG;IAC5B,GAAGR,MAAM;IACTI,KAAK,EAAED,cAAc;IACrBF,WAAW,EAAEA,WAAW,IAAIM;EAC9B,CAAC;;EAED;EACAV,kBAAkB,CAACY,QAAQ,CAACN,cAAc,IAAI,IAAI,CAAC;;EAEnD;EACAN,kBAAkB,CAACa,cAAc,CAAC,CAAC;EAEnC,OAAOf,qBAAqB,CAACI,UAAU,CAACS,qBAAqB,CAAC;AAChE","ignoreList":[]}
+{"version":3,"names":["OctopusReactNativeSdk","Appearance","colorSchemeManager","parseFontConfig","initialize","params","colorScheme","getColorScheme","processedTheme","theme","fonts","parsedConfig","undefined","paramsWithColorScheme","setTheme","startListening"],"sourceRoot":"../../src","sources":["initialize.ts"],"mappings":";;AAAA,SAASA,qBAAqB,QAAQ,6BAA0B;AAGhE,SAASC,UAAU,QAAQ,cAAc;AACzC,SAASC,kBAAkB,QAAQ,mCAAgC;AACnE,SAASC,eAAe,QAA+B,2BAAwB;;AAE/E;AACA;AACA;;AAYA;AACA;AACA;;AAGA;AACA;AACA;;AAMA;AACA;AACA;;AAQA;AACA;AACA;;AA0BA;AACA;AACA;AACA;AACA;AACA;AACA;;AAyBA;AACA;AACA;;AAUA;AACA;AACA;;AA0BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAACC,MAAwB,EAAiB;EAClE;EACA,MAAMC,WAAW,GAAGL,UAAU,CAACM,cAAc,CAAC,CAAC;;EAE/C;EACA,MAAMC,cAAc,GAAGH,MAAM,CAACI,KAAK,GAC/B;IACE,GAAGJ,MAAM,CAACI,KAAK;IACfC,KAAK,EAAEL,MAAM,CAACI,KAAK,CAACC,KAAK,GACrB;MACE,GAAGL,MAAM,CAACI,KAAK,CAACC,KAAK;MACrBC,YAAY,EAAER,eAAe,CAACE,MAAM,CAACI,KAAK,CAACC,KAAK;IAClD,CAAC,GACDE;EACN,CAAC,GACDA,SAAS;EAEb,MAAMC,qBAAqB,GAAG;IAC5B,GAAGR,MAAM;IACTI,KAAK,EAAED,cAAc;IACrBF,WAAW,EAAEA,WAAW,IAAIM;EAC9B,CAAC;;EAED;EACAV,kBAAkB,CAACY,QAAQ,CAACN,cAAc,IAAI,IAAI,CAAC;;EAEnD;EACAN,kBAAkB,CAACa,cAAc,CAAC,CAAC;EAEnC,OAAOf,qBAAqB,CAACI,UAAU,CAACS,qBAAqB,CAAC;AAChE","ignoreList":[]}

package/lib/typescript/src/initialize.d.ts

@@ -89,6 +89,17 @@ export interface OctopusTheme {
         image?: ImageResolvedAssetSource;
     };
 }
+/**
+ * UI customization options for platform-specific layout adjustments.
+ */
+export interface OctopusUIOptions {
+    /**
+     * Additional bottom inset applied to the Octopus UI.
+     * - On iOS, mapped to `bottomSafeAreaInset` (points)
+     * - On Android, mapped to `contentPadding` bottom (dp)
+     */
+    bottomSafeAreaInset?: number;
+}
 /**
  * Configuration params for initializing the Octopus SDK.
  */
@@ -111,6 +122,8 @@ export interface InitializeParams {
     };
     /** Optional theme customization for the Octopus UI */
     theme?: OctopusTheme;
+    /** Optional UI customization for layout-related tweaks */
+    ui?: OctopusUIOptions;
 }
 /**
  * Initializes the Octopus SDK with the provided configuration.

package/lib/typescript/src/initialize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initialize.d.ts","sourceRoot":"","sources":["../../../src/initialize.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAG7D,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gGAAgG;IAChG,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,+EAA+E;IAC/E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,UAAU,CAAC,EAAE;QACX,oCAAoC;QACpC,MAAM,CAAC,EAAE,gBAAgB,CAAC;QAC1B,oCAAoC;QACpC,MAAM,CAAC,EAAE,gBAAgB,CAAC;QAC1B,mCAAmC;QACnC,KAAK,CAAC,EAAE,gBAAgB,CAAC;QACzB,mCAAmC;QACnC,KAAK,CAAC,EAAE,gBAAgB,CAAC;QACzB,sCAAsC;QACtC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;QAC5B,sCAAsC;QACtC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;KAC7B,CAAC;IACF;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACxC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,MAAM,CAAC,EACH,eAAe,GACf;QACE,4BAA4B;QAC5B,KAAK,EAAE,eAAe,CAAC;QACvB,2BAA2B;QAC3B,IAAI,EAAE,eAAe,CAAC;KACvB,CAAC;IACN,iCAAiC;IACjC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,yBAAyB;IACzB,IAAI,CAAC,EAAE;QACL,0FAA0F;QAC1F,KAAK,CAAC,EAAE,wBAAwB,CAAC;KAClC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,cAAc,EACV;QACE,6BAA6B;QAC7B,IAAI,EAAE,KAAK,CAAC;QACZ,iEAAiE;QACjE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;KACtC,GACD;QACE,0CAA0C;QAC1C,IAAI,EAAE,SAAS,CAAC;KACjB,CAAC;IACN,sDAAsD;IACtD,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BlE"}
+{"version":3,"file":"initialize.d.ts","sourceRoot":"","sources":["../../../src/initialize.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAG7D,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gGAAgG;IAChG,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,+EAA+E;IAC/E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,UAAU,CAAC,EAAE;QACX,oCAAoC;QACpC,MAAM,CAAC,EAAE,gBAAgB,CAAC;QAC1B,oCAAoC;QACpC,MAAM,CAAC,EAAE,gBAAgB,CAAC;QAC1B,mCAAmC;QACnC,KAAK,CAAC,EAAE,gBAAgB,CAAC;QACzB,mCAAmC;QACnC,KAAK,CAAC,EAAE,gBAAgB,CAAC;QACzB,sCAAsC;QACtC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;QAC5B,sCAAsC;QACtC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;KAC7B,CAAC;IACF;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACxC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,MAAM,CAAC,EACH,eAAe,GACf;QACE,4BAA4B;QAC5B,KAAK,EAAE,eAAe,CAAC;QACvB,2BAA2B;QAC3B,IAAI,EAAE,eAAe,CAAC;KACvB,CAAC;IACN,iCAAiC;IACjC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,yBAAyB;IACzB,IAAI,CAAC,EAAE;QACL,0FAA0F;QAC1F,KAAK,CAAC,EAAE,wBAAwB,CAAC;KAClC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,cAAc,EACV;QACE,6BAA6B;QAC7B,IAAI,EAAE,KAAK,CAAC;QACZ,iEAAiE;QACjE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;KACtC,GACD;QACE,0CAA0C;QAC1C,IAAI,EAAE,SAAS,CAAC;KACjB,CAAC;IACN,sDAAsD;IACtD,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,0DAA0D;IAC1D,EAAE,CAAC,EAAE,gBAAgB,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BlE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octopus-community/react-native",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "React Native module for the Octopus Community SDK",
   "source": "./src/index.ts",
   "main": "./lib/module/index.js",

package/src/initialize.ts

@@ -101,6 +101,18 @@ export interface OctopusTheme {
   };
 }
 
+/**
+ * UI customization options for platform-specific layout adjustments.
+ */
+export interface OctopusUIOptions {
+  /**
+   * Additional bottom inset applied to the Octopus UI.
+   * - On iOS, mapped to `bottomSafeAreaInset` (points)
+   * - On Android, mapped to `contentPadding` bottom (dp)
+   */
+  bottomSafeAreaInset?: number;
+}
+
 /**
  * Configuration params for initializing the Octopus SDK.
  */
@@ -125,6 +137,8 @@ export interface InitializeParams {
       };
   /** Optional theme customization for the Octopus UI */
   theme?: OctopusTheme;
+  /** Optional UI customization for layout-related tweaks */
+  ui?: OctopusUIOptions;
 }
 
 /**