craft-native 0.0.293 → 0.0.299

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

@@ -45,6 +45,10 @@ export interface CraftAndroidConfig {
     renderer?: 'web' | 'native';
     /** "system" follows the device; light/dark pin the generated host. */
     appearance?: 'light' | 'dark' | 'system';
+    /** Static native tab-bar styling applied before the page's own tabBar.set call. */
+    tabBar?: CraftTabBarConfig;
+    /** Runs from the generated project root before Gradle compiles the app. */
+    postGenerate?: CraftPostGenerateHook;
     version?: string;
     versionCode?: number;
     darkMode?: boolean;
@@ -176,6 +180,19 @@ export interface CraftAndroidConfig {
         sessions?: boolean;
     };
 }
+export interface CraftTabBarConfig {
+    selection?: {
+        /** The selected tab indicator's corner radius in dp; omitted keeps the default. */
+        cornerRadius?: number;
+        /** The selected tab indicator fill as #RRGGBB. */
+        color?: string;
+    };
+}
+/** A declared command Craft runs after the native project has been generated. */
+export interface CraftPostGenerateHook {
+    command: string;
+    args?: string[];
+}
 /** The shared health data types (the iOS builder's HealthKit names). */
 export type HealthConnectType = 'steps' | 'heartRate' | 'activeEnergy' | 'distance' | 'workouts' | 'restingHeartRate' | 'heartRateVariability' | 'bodyMass' | 'sleep' | 'mindful' | 'dietaryEnergy' | 'dietaryProtein' | 'dietaryCarbohydrates' | 'dietaryFat' | 'bloodGlucose' | 'insulinDelivery';
 /**
@@ -227,6 +244,13 @@ export interface BuildOptions {
     /** Same meaning as `InitOptions.runtimeDir`; refreshes what init installed. */
     runtimeDir?: string | null;
 }
+/**
+ * Run the app's declared generator hook without invoking a shell.
+ *
+ * A hook gets the generated project as its cwd and explicit metadata so a
+ * patch can target the right platform and phase without guessing from paths.
+ */
+export declare function runPostGenerateHook(hook: CraftPostGenerateHook | undefined, output: string, phase?: 'build'): void;
 export interface OpenOptions {
     output: string;
 }

package/dist/android/src/index.js

@@ -507,6 +507,30 @@ function healthConnectPermissions(config) {
     permissions.add("android.permission.health.READ_HEALTH_DATA_HISTORY");
   return [...permissions];
 }
+function runPostGenerateHook(hook, output, phase = "build") {
+  if (!hook)
+    return;
+  if (typeof hook.command !== "string" || !hook.command.trim())
+    throw new Error("Android postGenerate.command must be a non-empty executable");
+  if (hook.args !== undefined && (!Array.isArray(hook.args) || hook.args.some((argument) => typeof argument !== "string")))
+    throw new Error("Android postGenerate.args must be an array of strings");
+  const command = [hook.command, ...hook.args ?? []];
+  let result;
+  try {
+    result = Bun.spawnSync(command, {
+      cwd: output,
+      env: { ...process.env, CRAFT_PROJECT_ROOT: output, CRAFT_PLATFORM: "android", CRAFT_GENERATE_PHASE: phase },
+      stdout: "inherit",
+      stderr: "pipe"
+    });
+  } catch (error) {
+    throw new Error(`Android postGenerate hook could not start in ${output}: ${hook.command}`, { cause: error });
+  }
+  if (result.exitCode !== 0) {
+    const stderr = result.stderr?.toString().trim();
+    throw new Error(`Android postGenerate hook failed in ${output} with exit code ${result.exitCode}${stderr ? `: ${stderr}` : ""}`);
+  }
+}
 var DEFAULT_CONFIG = {
   renderer: "web",
   version: "1.0.0",
@@ -634,6 +658,11 @@ function validateAndroidConfig(config) {
   if (config.appearance !== undefined && !["light", "dark", "system"].includes(config.appearance)) {
     throw new Error(`Unknown Android appearance: ${config.appearance}. Expected light, dark, or system.`);
   }
+  const selection = config.tabBar?.selection;
+  if (selection?.cornerRadius !== undefined && (!Number.isFinite(selection.cornerRadius) || selection.cornerRadius < 0))
+    throw new Error("Android tabBar.selection.cornerRadius must be a finite non-negative number");
+  if (selection?.color !== undefined && !/^#[0-9a-f]{6}$/i.test(selection.color))
+    throw new Error("Android tabBar.selection.color must be a #RRGGBB color");
   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}`);
@@ -1398,6 +1427,7 @@ async function build(options) {
     console.log(`   Synced: ${htmlPath} \u2192 assets/`);
   }
   syncNativeFonts(config.nativeFonts, output);
+  runPostGenerateHook(config.postGenerate, output);
   if (!compile)
     return;
   const gradlewPath = join3(output, "gradlew");
@@ -1486,6 +1516,7 @@ export {
   resolveRuntimeDir,
   run,
   runKotlinFixture,
+  runPostGenerateHook,
   syncAndroidWebAssets,
   syncNativeFonts
 };

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

@@ -86,6 +86,11 @@ internal data class CraftNativeTab(
     val selectedSymbol: String? = null, val selectedIconTint: String? = null, val selectedIconPulse: Boolean? = null,
 )
 
+internal data class CraftNativeTabBarAppearance(
+    val selectionColor: String? = null,
+    val selectionCornerRadius: Float? = null,
+)
+
 internal data class CraftTabIconAppearance(val symbol: String, val tint: Int?, val pulse: Boolean)
 
 /** The app's paths (`nativeScreens`), its tabs and its site. */
@@ -122,6 +127,16 @@ internal class CraftNativeRoutes(config: JSONObject) {
         }
     }
 
+    val tabBarAppearance: CraftNativeTabBarAppearance = config.optJSONObject("tabBar")
+        ?.optJSONObject("selection")
+        ?.let { selection ->
+            CraftNativeTabBarAppearance(
+                selection.optString("color").takeIf { it.isNotBlank() },
+                (selection.opt("cornerRadius") as? Number)?.toFloat()?.takeIf { it.isFinite() && it >= 0 },
+            )
+        }
+        ?: CraftNativeTabBarAppearance()
+
     /** The app's site (`devServerURL`): its origin answers paths no screen draws. */
     val site: Uri? = config.optString("devServerURL").takeIf { it.isNotBlank() }?.let(Uri::parse)
     val siteOrigin: String? = site?.let { uri ->
@@ -755,7 +770,11 @@ internal object CraftNativePrelude {
  * `craft.navigation.setOptions` (title, largeTitle, hidden, rightButtons,
  * tabAccessory, tabBarHidden); the tabs come from the app's `tabs`.
  */
-internal class CraftNativeChrome(context: Context, private val tabs: List<CraftNativeTab>) : LinearLayout(context) {
+internal class CraftNativeChrome(
+    context: Context,
+    private val tabs: List<CraftNativeTab>,
+    private val tabBarAppearance: CraftNativeTabBarAppearance = CraftNativeTabBarAppearance(),
+) : LinearLayout(context) {
     val content = FrameLayout(context)
     private val bar = LinearLayout(context)
     private val backButton = ImageView(context)
@@ -1099,6 +1118,7 @@ internal class CraftNativeChrome(context: Context, private val tabs: List<CraftN
         accessorySpec?.let { accessoryIcon.setImageDrawable(CraftNativeIcons.drawable(context, null, it.optString("symbol"), text)) }
         tabViews.forEachIndexed { index, (icon, label) ->
             tabBar.getChildAt(index).isSelected = index == selectedTab
+            tabBar.getChildAt(index).background = tabCellBackground(index, dark)
             val color = if (index == selectedTab) accent else muted
             val id = tabs[index].id
             val number = tabIconText[id]
@@ -1188,6 +1208,17 @@ internal class CraftNativeChrome(context: Context, private val tabs: List<CraftN
 
     private fun accentColor(dark: Boolean): Int = if (dark) Color.parseColor("#0A84FF") else Color.parseColor("#007AFF")
 
+    private fun tabCellBackground(index: Int, dark: Boolean): android.graphics.drawable.Drawable? {
+        if (index != selectedTab || (tabBarAppearance.selectionColor == null && tabBarAppearance.selectionCornerRadius == null)) return rippleBackground()
+        val color = tabBarAppearance.selectionColor?.let { runCatching { Color.parseColor(it) }.getOrNull() }
+            ?: if (dark) Color.argb(42, 255, 255, 255) else Color.argb(23, 0, 0, 0)
+        val radius = tabBarAppearance.selectionCornerRadius?.let { (it * density).toInt().toFloat() } ?: dp(32).toFloat()
+        return GradientDrawable().apply {
+            setColor(color)
+            cornerRadius = radius
+        }
+    }
+
     private fun rippleBackground(): android.graphics.drawable.Drawable? {
         val value = TypedValue()
         return if (context.theme.resolveAttribute(android.R.attr.selectableItemBackgroundBorderless, value, true)) {

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

@@ -2736,6 +2736,51 @@ private class CraftNativeIconView(context: Context) : TextView(context) {
     }
 }
 
+/** A platform EditText with the native end clear affordance and TalkBack action. */
+private class CraftNativeTextField(context: Context) : EditText(context) {
+    companion object { val CLEAR_ACTION_ID = View.generateViewId() }
+    var clearButtonMode = "never"
+    var onClearRequest: (() -> Unit)? = null
+    private var clearPressed = false
+    private fun showsClear() = isEnabled && keyListener != null && text?.isNotEmpty() == true && when (clearButtonMode) {
+        "always" -> true
+        "while-editing" -> isFocused
+        "unless-editing" -> !isFocused
+        else -> false
+    }
+    fun refreshClearButton() {
+        val icon = if (showsClear()) context.getDrawable(android.R.drawable.ic_menu_close_clear_cancel)?.mutate() else null
+        icon?.setTint(currentHintTextColor)
+        setCompoundDrawablesRelativeWithIntrinsicBounds(null, null, icon, null)
+    }
+    override fun onTextChanged(text: CharSequence?, start: Int, lengthBefore: Int, lengthAfter: Int) {
+        super.onTextChanged(text, start, lengthBefore, lengthAfter)
+        refreshClearButton()
+    }
+    override fun onFocusChanged(focused: Boolean, direction: Int, previouslyFocusedRect: android.graphics.Rect?) {
+        super.onFocusChanged(focused, direction, previouslyFocusedRect)
+        refreshClearButton()
+    }
+    override fun onTouchEvent(event: MotionEvent): Boolean {
+        val inClear = showsClear() && if (layoutDirection == View.LAYOUT_DIRECTION_RTL) event.x <= compoundPaddingLeft else event.x >= width - compoundPaddingRight
+        if (event.actionMasked == MotionEvent.ACTION_DOWN && inClear) { clearPressed = true; return true }
+        if (clearPressed) {
+            if (event.actionMasked == MotionEvent.ACTION_UP) { clearPressed = false; if (inClear) onClearRequest?.invoke(); return true }
+            if (event.actionMasked == MotionEvent.ACTION_CANCEL) clearPressed = false
+            return true
+        }
+        return super.onTouchEvent(event)
+    }
+    override fun onInitializeAccessibilityNodeInfo(info: android.view.accessibility.AccessibilityNodeInfo) {
+        super.onInitializeAccessibilityNodeInfo(info)
+        if (showsClear()) info.addAction(android.view.accessibility.AccessibilityNodeInfo.AccessibilityAction(CLEAR_ACTION_ID, "Clear text"))
+    }
+    override fun performAccessibilityAction(action: Int, arguments: Bundle?): Boolean {
+        if (action == CLEAR_ACTION_ID && showsClear()) { onClearRequest?.invoke(); return true }
+        return super.performAccessibilityAction(action, arguments)
+    }
+}
+
 private class CraftNativeModalView(context: Context) : FrameLayout(context) {
     val content = CraftNativeFlexLayout(context)
     private val blocker = View(context)
@@ -2745,6 +2790,16 @@ private class CraftNativeModalView(context: Context) : FrameLayout(context) {
     var onRequestClose: ((String) -> Unit)? = null
     var viewportStyle = JSONObject()
     var declarationPath = ""
+    var sheetFraction: Float? = null
+
+    override fun onMeasure(widthMeasureSpec: Int, heightMeasureSpec: Int) {
+        val fraction = sheetFraction
+        val params = content.layoutParams as LayoutParams
+        params.height = if (fraction == null) LayoutParams.MATCH_PARENT else (View.MeasureSpec.getSize(heightMeasureSpec) * fraction).toInt()
+        params.gravity = Gravity.BOTTOM
+        content.layoutParams = params
+        super.onMeasure(widthMeasureSpec, heightMeasureSpec)
+    }
 
     var transparent: Boolean = false
         set(value) {
@@ -3095,18 +3150,28 @@ internal class CraftNativeInputEcho {
     private var rendered: String? = null
     private var initialized = false
 
-    fun record(value: String) {
+    private var eventCount = 0
+
+    fun record(value: String): Int {
         pending.addLast(value)
         while (pending.size > 64) pending.removeFirst()
+        return ++eventCount
     }
 
-    fun accept(value: String?, nativeValue: String): Boolean {
+    fun accept(value: String?, nativeValue: String, acknowledged: Int? = null): Boolean {
         if (value == null) {
             initialized = false
             rendered = null
             pending.clear()
             return false
         }
+        if (acknowledged != null && acknowledged >= 0) {
+            if (acknowledged < eventCount) return false
+            pending.clear()
+            initialized = true
+            rendered = value
+            return nativeValue != value
+        }
         // A retained field can render the same prop more than once, after
         // its echo was consumed. That repeated prop must not overwrite a
         // keystroke that has not made the native/JS round trip yet.
@@ -4198,7 +4263,7 @@ class MainActivity : AppCompatActivity() {
     }
 
     private fun installChrome() {
-        val bars = CraftNativeChrome(this, routes.tabs)
+        val bars = CraftNativeChrome(this, routes.tabs, routes.tabBarAppearance)
         bars.layoutParams = FrameLayout.LayoutParams(-1, -1)
         bars.onBack = { onBackPressedDispatcherCompat() }
         bars.onAccessory = { path -> navigateOpen(path) }
@@ -4866,6 +4931,7 @@ class MainActivity : AppCompatActivity() {
         put("viewScroll")
         put("viewReparent")
         put("viewNonModalPresentation")
+        put("nativePlatformControls")
     }
 
     private fun appVersion(): Pair<String, String> = runCatching {
@@ -5360,7 +5426,7 @@ class MainActivity : AppCompatActivity() {
             previousId == null || previousId == protocolId || !screen.mutations.containsNode(previousId)
         }
         val previous = protocolId?.let { previousControls["id:$it"] } ?: keyedPrevious
-        val reusableInput = previous as? EditText
+        val reusableInput = previous as? CraftNativeTextField
         val control = when (type) {
             "Text" -> ((previous as? TextView)?.takeUnless { it is Button || it is EditText } ?: TextView(this)).apply {
                 includeFontPadding = false
@@ -5465,7 +5531,7 @@ class MainActivity : AppCompatActivity() {
                     }
                 }
             }
-            "TextInput" -> (reusableInput ?: EditText(this)).apply {
+            "TextInput" -> (reusableInput ?: CraftNativeTextField(this)).apply {
                 // Setting filters, the input type or single-line mode makes
                 // TextView set its text again, which puts the caret back at
                 // the start: typing then came out backwards. Each is set only
@@ -5531,9 +5597,21 @@ class MainActivity : AppCompatActivity() {
                 // them after keyed reconciliation.
                 val autofillHint = autofillHintFor(props)
                 if (autofillHint == null) setAutofillHints(*emptyArray()) else setAutofillHints(autofillHint)
+                clearButtonMode = craftNativeOptionalString(props.opt("clearButtonMode")) ?: "never"
+                onClearRequest = {
+                    if (isEnabled && keyListener != null) {
+                        screen.suppressedTextChanges.add(this)
+                        setText("")
+                        val eventCount = screen.inputEchoes.getOrPut(this) { CraftNativeInputEcho() }.record("")
+                        screen.handlers[this]?.let { current ->
+                            send(screen, "EVENT", JSONObject().put("handlerName", current).put("nativeEvent", JSONObject().put("text", "").put("clear", true).put("eventCount", eventCount)))
+                        }
+                    }
+                }
+                refreshClearButton()
                 val controlledValue = props.opt("value") as? String
                 val echoes = screen.inputEchoes.getOrPut(this) { CraftNativeInputEcho() }
-                if (echoes.accept(controlledValue, text.toString()) && controlledValue != null) {
+                if (echoes.accept(controlledValue, text.toString(), craftNativeInt(props.opt("mostRecentEventCount"), -1).takeIf { it >= 0 }) && controlledValue != null) {
                     screen.suppressedTextChanges.add(this)
                     setTextPreservingSelection(this, controlledValue)
                 }
@@ -5596,10 +5674,10 @@ class MainActivity : AppCompatActivity() {
                             (screen.inputIdentities[this@apply] ?: identity).let { screen.drafts[it] = updated }
                             if (screen.suppressedTextChanges.remove(this@apply)) return
                             val current = screen.handlers[this@apply] ?: return
-                            screen.inputEchoes.getOrPut(this@apply) { CraftNativeInputEcho() }.record(updated)
+                            val eventCount = screen.inputEchoes.getOrPut(this@apply) { CraftNativeInputEcho() }.record(updated)
                             send(screen, "EVENT", JSONObject()
                                 .put("handlerName", current)
-                                .put("nativeEvent", JSONObject().put("text", updated)))
+                                .put("nativeEvent", JSONObject().put("text", updated).put("eventCount", eventCount)))
                         }
                         override fun afterTextChanged(s: Editable?) {}
                     }
@@ -5607,6 +5685,57 @@ class MainActivity : AppCompatActivity() {
                     addTextChangedListener(watcher)
                 }
             }
+            "SegmentedControl" -> (previous as? android.widget.RadioGroup ?: android.widget.RadioGroup(this)).apply {
+                orientation = android.widget.LinearLayout.HORIZONTAL
+                // Reconciliation is silent. Only the platform's user selection
+                // listener below emits a value, with the stable option value.
+                setOnCheckedChangeListener(null)
+                val items = props.optJSONArray("items") ?: JSONArray()
+                val valuesChanged = childCount != items.length() || (0 until items.length()).any { index ->
+                    getChildAt(index)?.tag != craftNativePickerValue(items.optJSONObject(index)?.opt("value")).orEmpty()
+                }
+                if (valuesChanged) removeAllViews()
+                val requested = props.opt("value") as? String ?: craftNativePickerValue(props.opt("value")) ?: props.opt("selectedValue") as? String ?: craftNativePickerValue(props.opt("selectedValue"))
+                val disabled = craftNativeBoolean(props.opt("disabled"))
+                val foreground = color(craftNativeOptionalString(style.opt("color")).orEmpty(), Color.BLACK)
+                val values = mutableMapOf<Int, Pair<String, Int>>()
+                for (index in 0 until items.length()) {
+                    val item = items.optJSONObject(index) ?: continue
+                    val value = craftNativePickerValue(item.opt("value")) ?: ""
+                    val segment = (getChildAt(index) as? android.widget.RadioButton ?: android.widget.RadioButton(this@MainActivity)).apply {
+                        if (id == View.NO_ID) id = View.generateViewId()
+                        tag = value
+                        text = craftNativeOptionalString(item.opt("label")) ?: value
+                        contentDescription = craftNativeOptionalString(item.opt("spoken")) ?: text
+                        isEnabled = !disabled && !craftNativeBoolean(item.opt("disabled"))
+                        buttonDrawable = null
+                        gravity = Gravity.CENTER
+                        setTextColor(foreground)
+                        textSize = 13f
+                        minHeight = (32 * resources.displayMetrics.density).toInt()
+                        setPadding((8 * resources.displayMetrics.density).toInt(), 0, (8 * resources.displayMetrics.density).toInt(), 0)
+                        val selected = GradientDrawable().apply {
+                            setColor(color(craftNativeOptionalString(props.opt("tintColor")).orEmpty(), 0x33767680))
+                            cornerRadius = 7 * resources.displayMetrics.density
+                        }
+                        background = android.graphics.drawable.StateListDrawable().apply {
+                            addState(intArrayOf(android.R.attr.state_checked), selected)
+                            addState(intArrayOf(), ColorDrawable(Color.TRANSPARENT))
+                        }
+                        isChecked = value == requested
+                    }
+                    values[segment.id] = value to index
+                    if (segment.parent == null) addView(segment, android.widget.RadioGroup.LayoutParams(0, android.view.ViewGroup.LayoutParams.WRAP_CONTENT, 1f))
+                }
+                isEnabled = !disabled
+                val handler = craftNativeEventName(events, "onValueChange", "onChange")
+                if (handler.isNotBlank()) screen.handlers[this] = handler else screen.handlers.remove(this)
+                setOnCheckedChangeListener { _, checkedId ->
+                    val current = screen.handlers[this] ?: return@setOnCheckedChangeListener
+                    val (value, index) = values[checkedId] ?: return@setOnCheckedChangeListener
+                    send(screen, "EVENT", JSONObject().put("handlerName", current).put("nativeEvent", JSONObject().put("value", value).put("index", index)))
+                }
+            }
             "Picker" -> (previous as? Spinner ?: Spinner(this)).apply {
                 val itemOptions = props.optJSONArray("items")?.let { items ->
                     (0 until items.length()).mapNotNull { index ->
@@ -5676,6 +5805,14 @@ class MainActivity : AppCompatActivity() {
                 // the screen root. Keep the authored layout style with that
                 // promoted child so non-modal absolute coordinates remain in
                 // the screen viewport rather than the old clipped parent.
+                val sheetStyle = craftNativeOptionalString(props.opt("presentationStyle"))
+                val detents = props.optJSONArray("sheetDetents")
+                val firstDetent = detents?.optString(0)?.takeIf { it == "medium" || it == "large" } ?: "medium"
+                val selectedDetent = craftNativeOptionalString(props.opt("selectedDetent")) ?: firstDetent
+                val fraction = if (blocksBackground && sheetStyle in setOf("pageSheet", "formSheet")) {
+                    if (selectedDetent == "large") 0.92f else 0.5f
+                } else null
+                if (sheetFraction != fraction) { sheetFraction = fraction; requestLayout() }
                 viewportStyle = style
                 declarationPath = path
                 screen.view.setChildStyle(this, style, resources.displayMetrics.density)
@@ -5767,7 +5904,10 @@ class MainActivity : AppCompatActivity() {
                             intArrayOf(trueColor ?: resolvedFalse, resolvedFalse),
                         )
                     }
-                } ?: run { trackTintList = null }
+                } ?: run {
+                    val tint = craftNativeOptionalString(style.opt("color"))?.let { runCatching { craftNativeColor(it) }.getOrNull() }
+                    trackTintList = tint?.let { ColorStateList(arrayOf(intArrayOf(android.R.attr.state_checked), intArrayOf()), intArrayOf(it, Color.GRAY)) }
+                }
                 craftNativeOptionalString(props.opt("thumbColor"))
                     ?.let { runCatching { craftNativeColor(it) }.getOrNull() }
                     ?.let { thumbTintList = ColorStateList.valueOf(it) }
@@ -5853,7 +5993,7 @@ class MainActivity : AppCompatActivity() {
                 val animating = craftNativeBoolean(props.opt("animating"), true)
                 isIndeterminate = animating
                 visibility = if (!animating && craftNativeBoolean(props.opt("hidesWhenStopped"), true)) View.GONE else View.VISIBLE
-                indeterminateTintList = craftNativeOptionalString(props.opt("color"))
+                indeterminateTintList = (craftNativeOptionalString(props.opt("color")) ?: craftNativeOptionalString(style.opt("color")))
                     ?.let { runCatching { craftNativeColor(it) }.getOrNull() }
                     ?.let { ColorStateList.valueOf(it) }
             }
@@ -6085,7 +6225,7 @@ class MainActivity : AppCompatActivity() {
         val underlayHideHandler = if (type == "TouchableHighlight") craftNativeEventName(events, "onHideUnderlay").takeIf { it.isNotBlank() } else null
         if (underlayShowHandler != null) screen.pressUnderlayShowHandlers[control] = underlayShowHandler else screen.pressUnderlayShowHandlers.remove(control)
         if (underlayHideHandler != null) screen.pressUnderlayHideHandlers[control] = underlayHideHandler else screen.pressUnderlayHideHandlers.remove(control)
-        if (type != "Button" && type != "Link" && type != "Checkbox" && type != "TextInput" && type != "Picker" && type != "DatePicker" && type != "Modal" && type != "Switch" && type != "Slider" && type != "ActivityIndicator" && type != "KeyboardAvoidingView" && type != "StatusBar" && type != "RefreshControl" && type != "Map") {
+        if (type != "Button" && type != "Link" && type != "Checkbox" && type != "TextInput" && type != "Picker" && type != "SegmentedControl" && type != "DatePicker" && type != "Modal" && type != "Switch" && type != "Slider" && type != "ActivityIndicator" && type != "KeyboardAvoidingView" && type != "StatusBar" && type != "RefreshControl" && type != "Map") {
             val handler = craftNativeEventName(events, "onPress", "onClick")
             val disabled = craftNativeBoolean(props.opt("disabled"))
             val target = listOf(props.opt("href"), props.opt("to"))
@@ -6250,6 +6390,7 @@ class MainActivity : AppCompatActivity() {
         "link" -> "Link"
         "checkbox" -> "Checkbox"
         "textinput", "input" -> "TextInput"
+        "segmentedcontrol", "segmented-control" -> "SegmentedControl"
         "picker", "select" -> "Picker"
         "datepicker", "date-picker", "date" -> "DatePicker"
         "modal" -> "Modal"
@@ -7079,7 +7220,7 @@ class MainActivity : AppCompatActivity() {
         }
         val state = props.optJSONObject("accessibilityState")
         val disabled = craftNativeBoolean(props.opt("disabled")) || craftNativeBoolean(state?.opt("disabled"))
-        if (type !in setOf("Button", "Link", "Checkbox", "TextInput", "Picker", "DatePicker", "Modal", "Switch", "Slider", "ActivityIndicator")) {
+        if (type !in setOf("Button", "Link", "Checkbox", "TextInput", "Picker", "SegmentedControl", "DatePicker", "Modal", "Switch", "Slider", "ActivityIndicator")) {
             view.isEnabled = !disabled
         } else if (disabled) {
             view.isEnabled = false

package/dist/api/app.d.ts

@@ -361,11 +361,11 @@ declare class AppManager {
      */
     isShortcutRegistered(accelerator: string): Promise<boolean>;
     /**
-     * Set app appearance (macOS)
+     * Set the app appearance on native hosts.
      */
     setAppearance(appearance: 'light' | 'dark' | 'system'): Promise<void>;
     /**
-     * Get current appearance
+     * Get the current effective Light/Dark appearance.
      */
     getAppearance(): Promise<'light' | 'dark'>;
     /**

package/dist/cli.js

@@ -2945,7 +2945,7 @@ function pinCraftNativeDependency(packagePath, craftVersion) {
 `);
 }
 // package.json
-var version = "0.0.293";
+var version = "0.0.299";
 
 // bin/cli.ts
 var spawnedFrom = process6.env[CRAFT_CLI_SPAWN_MARKER];

package/dist/components/index.d.ts

@@ -721,6 +721,9 @@ export interface PressableProps extends ViewProps {
  * TextInput component props.
  */
 export interface TextInputProps extends BaseProps {
+    /** Runtime acknowledgement of the latest native edit; stale controlled echoes are ignored. */
+    mostRecentEventCount?: number;
+    clearButtonMode?: 'never' | 'while-editing' | 'unless-editing' | 'always';
     /** Style object or array */
     style?: StyleValue<TextStyle>;
     /** Current value */
@@ -831,6 +834,20 @@ export interface PickerProps extends BaseProps {
     onChange?: (value: string | number, index: number) => void;
     disabled?: boolean;
 }
+/** Platform-owned segmented selection (UISegmentedControl / Android RadioGroup). */
+export interface SegmentedControlProps extends BaseProps {
+    items: Array<PickerOption & {
+        disabled?: boolean;
+        spoken?: string;
+    }>;
+    value?: string | number;
+    disabled?: boolean;
+    tintColor?: string;
+    onValueChange?: (event: {
+        value: string;
+        index: number;
+    }) => void;
+}
 export interface DatePickerChange {
     value: string;
     iso: string;
@@ -890,6 +907,10 @@ export interface ModalProps extends BaseProps {
     nonModal?: boolean;
     /** When non-modal, consume an outside tap and call onRequestClose. */
     dismissOnOutsideTap?: boolean;
+    presentationStyle?: 'fullScreen' | 'pageSheet' | 'formSheet' | 'overFullScreen';
+    sheetDetents?: Array<'medium' | 'large'>;
+    selectedDetent?: 'medium' | 'large';
+    grabberVisible?: boolean;
     animationType?: 'none' | 'fade' | 'slide';
     onShow?: () => void;
     onDismiss?: () => void;

package/dist/index.cjs

@@ -374,7 +374,7 @@ function craftBinaryNotFoundMessage(triedPath) {
 `);
 }
 // package.json
-var version = "0.0.293";
+var version = "0.0.299";
 
 // src/sdk-version.ts
 var SDK_VERSION = version;

package/dist/index.js

@@ -117,7 +117,7 @@ function craftBinaryNotFoundMessage(triedPath) {
 `);
 }
 // package.json
-var version = "0.0.293";
+var version = "0.0.299";
 
 // src/sdk-version.ts
 var SDK_VERSION = version;

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

@@ -9,6 +9,19 @@ export declare function syncNativeFonts(fonts: CraftConfig['nativeFonts'], outpu
 /** This package's version, which the app names in its user agent (`Craft/<version>`). */
 export declare function resolveCraftVersion(startDir?: string): string;
 export type CraftAppearance = 'light' | 'dark' | 'system';
+/** A declared command Craft runs after the native project has been generated. */
+export interface CraftPostGenerateHook {
+    command: string;
+    args?: string[];
+}
+export interface CraftTabBarConfig {
+    selection?: {
+        /** The selected tab indicator's corner radius in points; omitted keeps a capsule. */
+        cornerRadius?: number;
+        /** The selected tab indicator fill as #RRGGBB. */
+        color?: string;
+    };
+}
 export interface CraftConfig {
     appShortcuts?: CraftAppShortcut[];
     /** Bundled font files keyed by their PostScript font name, used as native fontFamily. */
@@ -29,6 +42,10 @@ export interface CraftConfig {
      * and `dark` pin one. Unset keeps the older `darkMode` switch.
      */
     appearance?: CraftAppearance;
+    /** Static native tab-bar styling applied before the page's own tabBar.set call. */
+    tabBar?: CraftTabBarConfig;
+    /** Runs from the generated project root after `craft ios build` writes it. */
+    postGenerate?: CraftPostGenerateHook;
     backgroundColor?: string;
     /** The launch and webview background while the phone is in Dark Mode. */
     backgroundColorDark?: string;
@@ -409,6 +426,13 @@ export interface BuildOptions {
      */
     runtimeDir?: string | null;
 }
+/**
+ * Run the app's declared generator hook without invoking a shell.
+ *
+ * A hook gets the generated project as its cwd and explicit metadata so a
+ * patch can target the right platform and phase without guessing from paths.
+ */
+export declare function runPostGenerateHook(hook: CraftPostGenerateHook | undefined, output: string, phase?: 'build'): void;
 export interface OpenOptions {
     output: string;
 }

package/dist/ios/src/index.js

@@ -512,6 +512,30 @@ function installNativeBundle(source, output) {
 function hasInstalledNativeBundle(output) {
   return existsSync(join3(output, "dist", "native-screen.js")) || existsSync(join3(output, "dist", "native-screens"));
 }
+function runPostGenerateHook(hook, output, phase = "build") {
+  if (!hook)
+    return;
+  if (typeof hook.command !== "string" || !hook.command.trim())
+    throw new Error("iOS postGenerate.command must be a non-empty executable");
+  if (hook.args !== undefined && (!Array.isArray(hook.args) || hook.args.some((argument) => typeof argument !== "string")))
+    throw new Error("iOS postGenerate.args must be an array of strings");
+  const command = [hook.command, ...hook.args ?? []];
+  let result;
+  try {
+    result = Bun.spawnSync(command, {
+      cwd: output,
+      env: { ...process.env, CRAFT_PROJECT_ROOT: output, CRAFT_PLATFORM: "ios", CRAFT_GENERATE_PHASE: phase },
+      stdout: "inherit",
+      stderr: "pipe"
+    });
+  } catch (error) {
+    throw new Error(`iOS postGenerate hook could not start in ${output}: ${hook.command}`, { cause: error });
+  }
+  if (result.exitCode !== 0) {
+    const stderr = result.stderr?.toString().trim();
+    throw new Error(`iOS postGenerate hook failed in ${output} with exit code ${result.exitCode}${stderr ? `: ${stderr}` : ""}`);
+  }
+}
 var DEFAULT_CONFIG = {
   renderer: "web",
   version: "1.0.0",
@@ -1230,6 +1254,11 @@ async function init(options) {
   if (config.renderer !== "web" && config.renderer !== "native") {
     throw new Error(`Unknown iOS renderer: ${config.renderer}. Expected web or native.`);
   }
+  const selection = config.tabBar?.selection;
+  if (selection?.cornerRadius !== undefined && (!Number.isFinite(selection.cornerRadius) || selection.cornerRadius < 0))
+    throw new Error("iOS tabBar.selection.cornerRadius must be a finite non-negative number");
+  if (selection?.color !== undefined && !/^#[0-9a-f]{6}$/i.test(selection.color))
+    throw new Error("iOS tabBar.selection.color must be a #RRGGBB color");
   if (config.enableBackgroundLocation)
     config.enableGeolocation = true;
   const problems = hybridConfigProblems(config);
@@ -1425,6 +1454,7 @@ async function build(options) {
       cause: error
     });
   }
+  runPostGenerateHook(config.postGenerate, output);
   console.log("");
 }
 async function open(options) {
@@ -1590,6 +1620,7 @@ export {
   resolveRuntimeDir,
   restoreShell,
   run,
+  runPostGenerateHook,
   serializeSimulatorSteps,
   showSimulator,
   syncNativeFonts,