craft-native 0.0.122 → 0.0.124

package/README.md

@@ -470,6 +470,9 @@ should use the canonical spellings. A capability disabled by app configuration
 is distinct from a user denying permission, and `BUSY` is distinct from a failed
 native call.
 
+On iOS, `window.addEventListener('craftTabBarLayout', ...)` reports the native
+tab bar's current height as `{ detail: { height } }` in CSS pixels.
+
 ## Requirements
 
 - Bun >= 1.0.0 (for development)

package/dist/android/src/index.d.ts

@@ -9,10 +9,13 @@ export interface CraftAndroidConfig {
     appName: string;
     packageName: string;
     renderer?: 'web' | 'native';
+    /** "system" follows the device; light/dark pin the generated host. */
+    appearance?: 'light' | 'dark' | 'system';
     version?: string;
     versionCode?: number;
     darkMode?: boolean;
     backgroundColor?: string;
+    backgroundColorDark?: string;
     enableSpeechRecognition?: boolean;
     enableHaptics?: boolean;
     enableShare?: boolean;

package/dist/android/src/index.js

@@ -216,6 +216,9 @@ function validateAndroidConfig(config) {
   if (config.renderer !== undefined && config.renderer !== "web" && config.renderer !== "native") {
     throw new Error(`Unknown Android renderer: ${config.renderer}. Expected web or native.`);
   }
+  if (config.appearance !== undefined && !["light", "dark", "system"].includes(config.appearance)) {
+    throw new Error(`Unknown Android appearance: ${config.appearance}. Expected light, dark, or system.`);
+  }
   const packageSegments = config.packageName.split(".");
   if (packageSegments.length < 2 || packageSegments.some((segment) => !/^[A-Za-z_][A-Za-z0-9_]*$/.test(segment) || KOTLIN_KEYWORDS.has(segment))) {
     throw new Error(`Invalid Android package name: ${config.packageName}`);
@@ -223,6 +226,9 @@ function validateAndroidConfig(config) {
   if (!/^#(?:[\dA-F]{3,4}|[\dA-F]{6}|[\dA-F]{8})$/i.test(config.backgroundColor ?? "")) {
     throw new Error(`Invalid Android background color: ${config.backgroundColor}`);
   }
+  if (config.backgroundColorDark !== undefined && !config.backgroundColorDark.match(/^#[\dA-F]{3,4}$|^#[\dA-F]{6}$|^#[\dA-F]{8}$/i)) {
+    throw new Error(`Invalid Android dark background color: ${config.backgroundColorDark}`);
+  }
   for (const [name, value] of [
     ["versionCode", config.versionCode],
     ["minSdk", config.minSdk],
@@ -395,6 +401,7 @@ async function init(options) {
     join(output, "app/src/main/java", packagePath),
     join(output, "app/src/main/res/layout"),
     join(output, "app/src/main/res/values"),
+    join(output, "app/src/main/res/values-night"),
     join(output, "app/src/main/res/drawable"),
     join(output, "app/src/main/assets"),
     join(output, "gradle/wrapper")
@@ -508,6 +515,16 @@ zipStorePath=wrapper/dists
 </resources>
 `;
   writeFileSync(join(output, "app/src/main/res/values/colors.xml"), colorsXml);
+  const darkColorsPath = join(output, "app/src/main/res/values-night/colors.xml");
+  if (config.backgroundColorDark) {
+    writeFileSync(darkColorsPath, `<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="background">${config.backgroundColorDark}</color>
+</resources>
+`);
+  } else {
+    rmSync(darkColorsPath, { force: true });
+  }
   const appIconXml = `<?xml version="1.0" encoding="utf-8"?>
 <vector xmlns:android="http://schemas.android.com/apk/res/android"
     android:width="108dp"

package/dist/android/templates/AndroidManifest.xml.template

@@ -33,7 +33,7 @@
         <activity
             android:name=".MainActivity"
             android:exported="true"
-            android:configChanges="orientation|screenSize|screenLayout|keyboardHidden"
+            android:configChanges="orientation|screenSize|screenLayout|keyboardHidden|uiMode"
             android:windowSoftInputMode="adjustResize"
             android:launchMode="singleTask">
             <intent-filter>

package/dist/android/templates/CraftNativeFlatList.kt.template

@@ -37,12 +37,16 @@ internal class CraftNativeFlatList(context: Context) : RecyclerView(context) {
         override fun getItemId(position: Int): Long = stableId(getItem(position).identity)
 
         override fun onCreateViewHolder(parent: ViewGroup, viewType: Int) = Holder(FrameLayout(parent.context).apply {
-            layoutParams = LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.WRAP_CONTENT)
+            layoutParams = LayoutParams(
+                if (horizontal) LayoutParams.WRAP_CONTENT else LayoutParams.MATCH_PARENT,
+                LayoutParams.WRAP_CONTENT,
+            )
         })
 
         override fun onBindViewHolder(holder: Holder, position: Int) {
             val item = getItem(position)
             if (holder.identity != null && holder.identity != item.identity) release(holder)
+            holder.host.layoutParams = holderLayoutParams()
             val view = renderItem?.invoke(item.node, item.identity, holder.hostedView) ?: View(holder.host.context)
             val renderedLayout = view.layoutParams
             val hostedLayout = FrameLayout.LayoutParams(
@@ -83,19 +87,97 @@ internal class CraftNativeFlatList(context: Context) : RecyclerView(context) {
     private var endReached: (() -> Unit)? = null
     private var threshold = 0.1
     private var endReachedSignature: String? = null
+    private var dataContentSignature = ""
     private var horizontal = false
     private var columns = 1
     private var submissionGeneration = 0
     private var isSubmittingList = false
+    private var pendingThemeRefresh = false
+    var onScrollEvent: (() -> Unit)? = null
+    var onScrollBeginDrag: (() -> Unit)? = null
+    var onScrollEndDrag: (() -> Unit)? = null
+    var onMomentumScrollBegin: (() -> Unit)? = null
+    var onMomentumScrollEnd: (() -> Unit)? = null
+    var onLayoutChanged: (() -> Unit)? = null
+
+    private fun holderLayoutParams() = LayoutParams(
+        if (horizontal) LayoutParams.WRAP_CONTENT else LayoutParams.MATCH_PARENT,
+        LayoutParams.WRAP_CONTENT,
+    )
+
+    private fun updateVisibleHolderLayoutParams() {
+        for (index in 0 until childCount) {
+            (getChildViewHolder(getChildAt(index)) as? Holder)?.host?.layoutParams = holderLayoutParams()
+        }
+    }
+
+    override fun onLayout(changed: Boolean, left: Int, top: Int, right: Int, bottom: Int) {
+        super.onLayout(changed, left, top, right, bottom)
+        onLayoutChanged?.invoke()
+    }
 
     init {
         adapter = listAdapter
         itemAnimator = null
         addOnScrollListener(object : OnScrollListener() {
-            override fun onScrolled(recyclerView: RecyclerView, dx: Int, dy: Int) = evaluateEndReached()
+            private var dragging = false
+            private var momentum = false
+
+            override fun onScrolled(recyclerView: RecyclerView, dx: Int, dy: Int) {
+                onScrollEvent?.invoke()
+                onLayoutChanged?.invoke()
+                evaluateEndReached()
+            }
+
+            override fun onScrollStateChanged(recyclerView: RecyclerView, newState: Int) {
+                when (newState) {
+                    RecyclerView.SCROLL_STATE_DRAGGING -> if (!dragging) {
+                        dragging = true
+                        onScrollBeginDrag?.invoke()
+                    }
+                    RecyclerView.SCROLL_STATE_SETTLING -> {
+                        if (dragging) {
+                            dragging = false
+                            onScrollEndDrag?.invoke()
+                        }
+                        if (!momentum) {
+                            momentum = true
+                            onMomentumScrollBegin?.invoke()
+                        }
+                    }
+                    RecyclerView.SCROLL_STATE_IDLE -> {
+                        if (dragging) {
+                            dragging = false
+                            onScrollEndDrag?.invoke()
+                        }
+                        if (momentum) {
+                            momentum = false
+                            onMomentumScrollEnd?.invoke()
+                        }
+                    }
+                }
+            }
         })
     }
 
+    fun setKeyboardDismissMode(mode: String, dismissKeyboard: () -> Unit) {
+        if (mode !in setOf("on-drag", "interactive")) {
+            setOnTouchListener(null)
+            return
+        }
+        var dismissed = false
+        setOnTouchListener { _, event ->
+            when (event.actionMasked) {
+                android.view.MotionEvent.ACTION_DOWN -> dismissed = false
+                android.view.MotionEvent.ACTION_MOVE -> if (!dismissed) {
+                    dismissed = true
+                    dismissKeyboard()
+                }
+            }
+            false
+        }
+    }
+
     fun apply(
         nodes: List<JSONObject>,
         horizontal: Boolean,
@@ -116,7 +198,10 @@ internal class CraftNativeFlatList(context: Context) : RecyclerView(context) {
         val retainedState = if (layoutChanged) null else layoutManager?.onSaveInstanceState()
         this.horizontal = horizontal
         this.columns = nextColumns
-        if (layoutChanged || layoutManager == null) configureLayoutManager()
+        if (layoutChanged || layoutManager == null) {
+            configureLayoutManager()
+            updateVisibleHolderLayoutParams()
+        }
 
         val seen = mutableMapOf<String, Int>()
         val next = nodes.mapIndexed { index, node ->
@@ -132,7 +217,10 @@ internal class CraftNativeFlatList(context: Context) : RecyclerView(context) {
         val nextIds = next.mapTo(mutableSetOf()) { it.identity }
         (oldIds - nextIds).forEach(recycleItem)
         val dataItems = next.filterNot { it.chrome }
-        val contentSignature = "${dataItems.size}:${dataItems.lastOrNull()?.identity.orEmpty()}"
+        val contentSignature = dataItems.joinToString("") {
+            "${it.identity.length}:${it.identity}${it.signature.length}:${it.signature}"
+        }
+        dataContentSignature = contentSignature
         if (contentSignature != endReachedSignature) endReachedSignature = null
         val generation = ++submissionGeneration
         isSubmittingList = true
@@ -140,6 +228,10 @@ internal class CraftNativeFlatList(context: Context) : RecyclerView(context) {
             if (generation != submissionGeneration) return@submitList
             retainedState?.let { layoutManager?.onRestoreInstanceState(it) }
             isSubmittingList = false
+            if (pendingThemeRefresh) {
+                pendingThemeRefresh = false
+                refreshThemeDefaults()
+            }
             evaluateEndReached()
         }
     }
@@ -148,12 +240,28 @@ internal class CraftNativeFlatList(context: Context) : RecyclerView(context) {
         listAdapter.currentList.forEach { recycleItem?.invoke(it.identity) }
         val generation = ++submissionGeneration
         isSubmittingList = true
+        pendingThemeRefresh = false
         listAdapter.submitList(emptyList()) {
             if (generation == submissionGeneration) isSubmittingList = false
         }
         renderItem = null
         recycleItem = null
         endReached = null
+        dataContentSignature = ""
+        onScrollEvent = null
+        onScrollBeginDrag = null
+        onScrollEndDrag = null
+        onMomentumScrollBegin = null
+        onMomentumScrollEnd = null
+        onLayoutChanged = null
+    }
+
+    fun refreshThemeDefaults() {
+        if (isSubmittingList) {
+            pendingThemeRefresh = true
+            return
+        }
+        if (listAdapter.itemCount > 0) listAdapter.notifyItemRangeChanged(0, listAdapter.itemCount)
     }
 
     private fun configureLayoutManager() {
@@ -179,8 +287,7 @@ internal class CraftNativeFlatList(context: Context) : RecyclerView(context) {
         val remaining = dataPositions.size - lastDataOrdinal - 1
         val thresholdItems = maxOf(1, ceil(dataPositions.size * threshold).toInt())
         if (remaining > thresholdItems) return
-        val lastIdentity = listAdapter.currentList[dataPositions.last()].identity
-        val signature = "${dataPositions.size}:$lastIdentity"
+        val signature = dataContentSignature
         if (endReachedSignature == signature) return
         endReachedSignature = signature
         endReached?.invoke()

package/dist/android/templates/MainActivity.kt.template

@@ -17,6 +17,7 @@ import android.webkit.WebSettings
 import android.webkit.WebView
 import android.webkit.WebViewClient
 import androidx.appcompat.app.AppCompatActivity
+import androidx.appcompat.app.AppCompatDelegate
 import androidx.core.view.WindowCompat
 import androidx.webkit.WebViewAssetLoader
 import org.json.JSONObject
@@ -75,6 +76,7 @@ class MainActivity : AppCompatActivity() {
 
     @SuppressLint("SetJavaScriptEnabled")
     override fun onCreate(savedInstanceState: Bundle?) {
+        applyConfiguredAppearance()
         super.onCreate(savedInstanceState)
 
         // Enable edge-to-edge
@@ -111,6 +113,21 @@ class MainActivity : AppCompatActivity() {
         setupNetworkMonitoring()
     }
 
+    private fun applyConfiguredAppearance() {
+        val configured = configJson()
+        val mode = when (configured?.optString("appearance")) {
+            "light" -> AppCompatDelegate.MODE_NIGHT_NO
+            "dark" -> AppCompatDelegate.MODE_NIGHT_YES
+            "system" -> AppCompatDelegate.MODE_NIGHT_FOLLOW_SYSTEM
+            else -> if (configured?.optBoolean("darkMode", true) == false) {
+                AppCompatDelegate.MODE_NIGHT_NO
+            } else {
+                AppCompatDelegate.MODE_NIGHT_YES
+            }
+        }
+        AppCompatDelegate.setDefaultNightMode(mode)
+    }
+
     @SuppressLint("SetJavaScriptEnabled")
     private fun setupWebView() {
         webView.settings.apply {