react-native-unified-action-sheet 0.1.1 → 0.3.0

package/CHANGELOG.md

@@ -7,6 +7,69 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0]
+
+### Added
+
+- `presentationStyle: 'bottom'`: a native bottom sheet on both platforms, with
+  a drag handle and swipe to dismiss. A long list opens part-way and drags up
+  to expand. On iOS it is a `UISheetPresentationController` sheet with native
+  rows (on iPad, the action sheet's popover instead); on Android, a Material 3
+  bottom sheet. `anchor` is ignored for it.
+- Material is opt-in, so apps that don't use the bottom sheet stay free of the
+  dependency. Set `unifiedActionSheet.material=true` in
+  `android/gradle.properties`. Only then does the library add
+  `com.google.android.material` (1.12.0 by default; override it with
+  `ext.materialVersion` or `unifiedActionSheet.materialVersion`).
+- An Expo config plugin that writes those properties:
+  `plugins: [['react-native-unified-action-sheet', { material: true }]]`, with
+  an optional `materialVersion`. `@expo/config-plugins` is an optional peer
+  dependency.
+
+### Fixed
+
+- On iOS, a sheet, alert or prompt stayed on screen after a JS reload (pressing
+  `r` in Metro). It now closes on reload, as it already did on Android, and its
+  promise is left unresolved, since it belonged to the discarded runtime.
+
+### Notes
+
+- Without the Material opt-in, `'bottom'` on Android falls back to the centered
+  dialog, and warns once in development.
+- Prompts do not support `'bottom'`; they stay centered on both platforms.
+
+## [0.2.0]
+
+### Added
+
+- `showPromptWithOptions(options)` — the same native dialog as the action sheet,
+  with a text field. React Native's own `Alert.prompt` is iOS-only and silently
+  does nothing on Android, so this is the one API here with no core equivalent.
+  Resolves `{ buttonIndex, text }`, or `undefined` after `dismissActionSheet()`.
+- Prompt button handlers receive the field's text. It is read when the prompt
+  closes, including on a dismissal, so a draft is recoverable rather than lost.
+- Prompt options: `placeholder`, `defaultValue`, `secureTextEntry` and
+  `keyboardType` (`'default' | 'email-address' | 'numeric' | 'phone-pad' |
+  'url'`). Buttons keep the sheet's `style`, `disabled` and `onPress`.
+- `setNextPromptResult({ buttonIndex, text })` in the shipped Jest mock, the
+  prompt counterpart to `setNextButtonIndex()`.
+- Exported types: `PromptButtonInterface`, `PromptCommonOptionsInterface`,
+  `PromptAndroidOptionsInterface`, `PromptOptionsInterface`,
+  `PromptResultInterface`, plus the shared `BaseButtonInterface`,
+  `BaseOptionsInterface` and `BaseAndroidOptionsInterface`.
+
+### Changed
+
+- The options and button fields the sheet and the prompt share are now declared
+  once, in `BaseOptionsInterface` / `BaseButtonInterface`, which both APIs
+  extend. No public type changed shape.
+
+### Notes
+
+- A prompt is always presented centered. UIKit has no text field in an action
+  sheet, so `presentationStyle` and `anchor` do not apply to one.
+- `dismissActionSheet()` and `dismissAllActionSheets()` close prompts too.
+
 ## [0.1.1]
 
 No user-facing changes — the library is identical to 0.1.0. Republished from CI
@@ -43,6 +106,8 @@ Initial release.
 - No `com.google.android.material` dependency, and no runtime dependencies —
   `react` and `react-native` are peers.
 
-[unreleased]: https://github.com/galikvalkin/react-native-unified-action-sheet/compare/v0.1.1...HEAD
+[unreleased]: https://github.com/galikvalkin/react-native-unified-action-sheet/compare/v0.3.0...HEAD
+[0.3.0]: https://github.com/galikvalkin/react-native-unified-action-sheet/compare/v0.2.0...v0.3.0
+[0.2.0]: https://github.com/galikvalkin/react-native-unified-action-sheet/compare/v0.1.1...v0.2.0
 [0.1.1]: https://github.com/galikvalkin/react-native-unified-action-sheet/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/galikvalkin/react-native-unified-action-sheet/releases/tag/v0.1.0

package/README.md

@@ -1,21 +1,16 @@
 # react-native-unified-action-sheet
 
-Unified action sheet API for React Native: a native `UIAlertController` on iOS, a native `AppCompatDialog` on Android.
+Unified native action sheet for React Native, one API on iOS and Android.
 
-| Android | Android (dark mode) | iOS |
+| | Light | Dark |
 | :---: | :---: | :---: |
-| <img src="https://raw.githubusercontent.com/galikvalkin/react-native-unified-action-sheet/HEAD/docs/android-demo.gif" width="280" alt="Android demo" /> | <img src="https://raw.githubusercontent.com/galikvalkin/react-native-unified-action-sheet/HEAD/docs/android-demo-dark-mode.gif" width="280" alt="Android dark-mode demo — following the system dark theme" /> | <img src="https://raw.githubusercontent.com/galikvalkin/react-native-unified-action-sheet/HEAD/docs/ios-demo.gif" width="280" alt="iOS demo" /> |
+| **Android** | <img src="https://raw.githubusercontent.com/galikvalkin/react-native-unified-action-sheet/HEAD/docs/images/android-demo-light-mode.gif" width="280" alt="Android demo in light mode" /> | <img src="https://raw.githubusercontent.com/galikvalkin/react-native-unified-action-sheet/HEAD/docs/images/android-demo-dark-mode.gif" width="280" alt="Android demo in dark mode" /> |
+| **iOS** | <img src="https://raw.githubusercontent.com/galikvalkin/react-native-unified-action-sheet/HEAD/docs/images/ios-demo-light-mode.gif" width="280" alt="iOS demo in light mode" /> | <img src="https://raw.githubusercontent.com/galikvalkin/react-native-unified-action-sheet/HEAD/docs/images/ios-demo-dark-mode.gif" width="280" alt="iOS demo in dark mode" /> |
 
-<p align="center">
-  <img src="https://raw.githubusercontent.com/galikvalkin/react-native-unified-action-sheet/HEAD/docs/ipad-demo.gif" width="420" alt="iPad demo — the sheet as a popover anchored to the button that opened it" />
-  <br />
-  <em>iPad: the same sheet presented as a popover, anchored to the view that opened it.</em>
-</p>
-
-- **Fully native, always on top.** The sheet gets its own platform window, so it renders above your entire React Native view tree — including above an already-open [`Modal`](https://reactnative.dev/docs/modal). JS-rendered action sheets live *inside* the component tree, where `overflow`, `zIndex`, a transform or an open modal can clip or bury them.
-- **One API, native on both platforms**, so the same options behave the same way.
-- Works on React Native **0.81 (old and new architecture)** through the **latest** release.
-- **No extra native dependencies** on either platform, and zero runtime dependencies (`react` / `react-native` peers only).
+- **Fully native, always on top.** The sheet gets its own platform window, so it renders above your whole view tree, including an open [`Modal`](https://reactnative.dev/docs/modal). JS-rendered sheets live inside the component tree, where `overflow`, `zIndex` or a modal can clip or bury them.
+- **One API on both platforms**: action sheets, anchored popovers, bottom sheets and text prompts.
+- **Prompts on Android too.** React Native's `Alert.prompt` is iOS-only; `showPromptWithOptions()` works on both.
+- **No dependencies.** `react` and `react-native` are peers; the Android bottom sheet's Material is opt-in.
 
 ## Installation
 
@@ -25,7 +20,9 @@ npm install react-native-unified-action-sheet
 yarn add react-native-unified-action-sheet
 ```
 
-Autolinking handles the rest on both platforms. In Expo apps, use a development build (`npx expo run:ios` / `npx expo run:android`) — custom native modules do not work in **Expo Go**.
+Autolinking handles the rest. In Expo, use a development build (`npx expo run:ios` / `npx expo run:android`); custom native modules do not work in Expo Go.
+
+**Optional:** for the Android bottom sheet, set `unifiedActionSheet.material=true` in `android/gradle.properties`, or add the Expo plugin. See [Bottom sheets](docs/bottom-sheet.md).
 
 ## Usage
 
@@ -44,108 +41,44 @@ await showActionSheetWithOptions({
 });
 ```
 
-Each button is an object. `style` marks the two native roles, which are mutually exclusive; `disabled` is independent of it; and `onPress` runs when that button resolves the sheet, so reordering buttons cannot send one down another's branch. The call also resolves with the tapped index, and the two never disagree:
-
-| | promise resolves with | `onPress` runs |
-| --- | --- | --- |
-| Tapping a button | its index | that button's |
-| Backdrop tap, back button, swipe down | the `'cancel'` button's index, or `-1` if there is none | the cancel button's, if there is one |
-| `dismissActionSheet()` | `undefined` | nothing |
-
-The promise never rejects on its own — only if one of your own `onPress` handlers throws.
-
-### Anchored sheets
+The call resolves with the tapped button's index, and that button's `onPress` runs. A backdrop tap or back resolves the `'cancel'` button. The promise never rejects. See [Behavior](docs/behavior.md).
 
-`presentationStyle: 'anchored'` attaches the sheet to a view. Pass the ref itself; the library measures it and sends only the resulting rectangle across:
+### Presentation styles
 
-```tsx
-const anchorRef = useRef<View>(null);
-
-<Pressable
-  ref={anchorRef}
-  onPress={() =>
-    showActionSheetWithOptions({
-      options: [...],
-      presentationStyle: 'anchored',
-      anchor: anchorRef,
-    })
-  }
-/>;
-```
-
-Anything with a `measureInWindow` method works, which is every React Native host component ref. On iOS the anchor only applies on iPad, where the sheet becomes a popover; iPhone always presents from the bottom.
-
-### Dismissing from code
-
-`dismissActionSheet()` closes the most recently opened sheet, `dismissAllActionSheets()` closes every open one. Both are no-ops when nothing is open, and the dismissed sheets resolve with `undefined`.
-
-```ts
-import {
-  dismissActionSheet,
-  dismissAllActionSheets,
-} from 'react-native-unified-action-sheet';
-```
+| `presentationStyle` | iOS | Android |
+| --- | --- | --- |
+| unset | Action sheet from the bottom | Centered dialog |
+| `'centered'` | Centered alert | Centered dialog |
+| `'anchored'` | Popover on iPad, pointing at `anchor` | Popup attached to `anchor` |
+| `'bottom'` | Sheet with a grabber (popover on iPad) | Material bottom sheet ([opt-in](docs/bottom-sheet.md)) |
 
-### Options
-
-| Option | Type | iOS | Android | Description |
-| --- | --- | :---: | :---: | --- |
-| `options` | `ActionSheetButtonInterface[]` | ✅ | ✅ | The buttons, in order: `{ label, style?, disabled?, onPress? }`. |
-| `style` (per button) | `'cancel' \| 'destructive'?` | ✅ | ✅ | `'cancel'` renders a separated cancel row on Android and resolves on backdrop tap / back; `'destructive'` renders in the destructive color. Only the first `'cancel'` counts. |
-| `disabled` (per button) | `boolean?` | ✅ | ✅ | Renders the row dimmed and unresponsive to taps. |
-| `onPress` (per button) | `() => void?` | ✅ | ✅ | Runs when this button resolves the sheet. |
-| `title` | `string?` | ✅ | ✅ | Sheet title. |
-| `message` | `string?` | ✅ | ✅ | Secondary text under the title. |
-| `presentationStyle` | `'centered' \| 'anchored'` | ✅ | ✅ | `'centered'` is a centered dialog; `'anchored'` attaches to `anchor` (an iPad popover on iOS). **Defaults differ**: Android defaults to `'centered'`, iOS to the standard action sheet. |
-| `anchor` | `ActionSheetAnchorInterface?` | ✅ | ✅ | The view to attach to — a ref, or anything with `measureInWindow`. Without a measurable anchor an `'anchored'` sheet falls back to a centered dialog. |
-| `anchorAlignment` | `'start' \| 'center'` | — | ✅ | Alignment of an `'anchored'` popup relative to its anchor. `'start'` (default) aligns leading edges, flipping in RTL. |
-| `userInterfaceStyle` | `'light' \| 'dark'` | ✅ | ✅ | Forces the appearance; defaults to following the system setting. |
-| `tintColor` | `string?` | ✅ | ✅ | Text color of non-destructive buttons. |
-| `cancelButtonTintColor` | `string?` | ✅ | ✅ | Text color of the cancel button; overrides `tintColor` for that row. |
-| `destructiveColor` | `string?` | ✅ | ✅ | Overrides the destructive row color (Android's palette error color, iOS system red). |
-| `buttonTextAlignment` | `'start' \| 'center'` | — | ✅ | Alignment of button labels. Defaults to `'start'`, which follows layout direction. |
-
-The options types are exported for typing your own wrappers:
+### Prompts
 
 ```ts
-import type {
-  ActionSheetOptionsInterface, // what showActionSheetWithOptions accepts
-  ActionSheetCommonOptionsInterface,
-  ActionSheetAndroidOptionsInterface,
-  ActionSheetButtonInterface, // a single button
-  ActionSheetAnchorInterface, // anything with measureInWindow
-} from 'react-native-unified-action-sheet';
-```
-
-### Platform notes
-
-- **Which gestures dismiss differs.** On iOS a sheet can only be tapped away if it has a `'cancel'` button, and a `'centered'` one never can — UIKit treats it as strictly modal. Android's centered dialog always cancels on a backdrop tap. Give a sheet a cancel button if you want that gesture everywhere.
-- **On iPad, a popover hides the cancel row**, since tapping outside already cancels. The index you receive is unaffected.
-- **Sheets stack.** Opening one over another puts it on top, and each resolves its own promise. Opening a sheet over a `Modal` does not dismiss the modal.
-- **Light or dark follows the system setting** unless `userInterfaceStyle` forces one, chosen when the sheet opens. The sheet uses its own palette, so it looks the same in any host app.
-- **Long lists scroll**, with the title and message pinned above them.
-- On Android, a sheet with no available activity resolves the cancel index rather than hanging, so a cancel handler can run for a sheet that never appeared.
+import { showPromptWithOptions } from 'react-native-unified-action-sheet';
 
-## Testing
-
-The package ships a Jest mock, so a screen that opens a sheet can be tested without the native module:
-
-```ts
-jest.mock('react-native-unified-action-sheet', () =>
-  require('react-native-unified-action-sheet/jest')
-);
+const result = await showPromptWithOptions({
+  title: 'Rename item',
+  placeholder: 'New name',
+  defaultValue: 'Untitled',
+  options: [
+    { label: 'Save', onPress: (text) => rename(text) },
+    { label: 'Cancel', style: 'cancel' },
+  ],
+});
+// { buttonIndex, text }, or undefined after dismissActionSheet().
 ```
 
-Every sheet then resolves with no selection. To simulate a tap, queue the index the next sheet should resolve with — the pressed button's `onPress` runs, just as it would for real:
+### Dismissing from code
 
-```ts
-import { setNextButtonIndex } from 'react-native-unified-action-sheet/jest';
+`dismissActionSheet()` closes the most recently opened sheet, and `dismissAllActionSheets()` closes every open one. Dismissed sheets resolve with `undefined`.
 
-setNextButtonIndex(0);
-await openTheSheet();
-```
+## Documentation
 
-Prefer that over `mockResolvedValueOnce`, which replaces the implementation and so skips `onPress`. `dismissActionSheet` and `dismissAllActionSheets` are plain spies.
+- [API reference](docs/api.md): every option, per platform
+- [Behavior](docs/behavior.md): what each gesture resolves with, and platform differences
+- [Bottom sheets](docs/bottom-sheet.md): both platforms, and enabling Material on Android
+- [Testing](docs/testing.md): the shipped Jest mock
 
 ## Compatibility
 

package/android/build.gradle

@@ -2,7 +2,8 @@ buildscript {
   ext.UnifiedActionSheet = [
     kotlinVersion: "2.0.21",
     minSdkVersion: 24,
-    compileSdkVersion: 36
+    compileSdkVersion: 36,
+    materialVersion: "1.12.0"
   ]
 
   ext.getExtOrDefault = { prop ->
@@ -31,6 +32,20 @@ apply plugin: "kotlin-android"
 
 apply plugin: "com.facebook.react"
 
+// Material is opt-in, so apps that don't use presentationStyle 'bottom' stay
+// free of the dependency. The app sets unifiedActionSheet.material=true in its
+// gradle.properties (the Expo config plugin writes it); only then is the
+// Material presenter compiled and the dependency added. src/main never
+// references a Material class: it goes through BottomSheetPresenterFactory,
+// which both variant source sets define.
+def materialEnabled = (findProperty("unifiedActionSheet.material") ?: "false").toString().toBoolean()
+
+// ext.materialVersion on the root project wins, then the gradle property, then
+// the version this library is tested against.
+def materialVersion = rootProject.ext.has("materialVersion")
+  ? rootProject.ext.get("materialVersion")
+  : (findProperty("unifiedActionSheet.materialVersion") ?: UnifiedActionSheet.materialVersion)
+
 android {
   namespace "com.unifiedactionsheet"
 
@@ -40,6 +55,15 @@ android {
     minSdkVersion getExtOrDefault("minSdkVersion")
   }
 
+  sourceSets {
+    main {
+      java.srcDirs += materialEnabled ? "src/material/java" : "src/noMaterial/java"
+      if (materialEnabled) {
+        res.srcDirs += "src/material/res"
+      }
+    }
+  }
+
   compileOptions {
     sourceCompatibility JavaVersion.VERSION_17
     targetCompatibility JavaVersion.VERSION_17
@@ -48,4 +72,7 @@ android {
 
 dependencies {
   implementation "com.facebook.react:react-android"
+  if (materialEnabled) {
+    implementation "com.google.android.material:material:${materialVersion}"
+  }
 }

package/android/src/main/java/com/unifiedactionsheet/ActionSheetOptions.kt

@@ -6,11 +6,15 @@ import com.facebook.react.bridge.ReadableMap
 internal enum class PresentationStyle {
   CENTERED,
   ANCHORED,
+  BOTTOM,
   ;
 
   companion object {
-    fun fromWire(value: String?): PresentationStyle =
-      if (value == "anchored") ANCHORED else CENTERED
+    fun fromWire(value: String?): PresentationStyle = when (value) {
+      "anchored" -> ANCHORED
+      "bottom" -> BOTTOM
+      else -> CENTERED
+    }
   }
 }
 

package/android/src/main/java/com/unifiedactionsheet/PromptOptions.kt

@@ -0,0 +1,132 @@
+package com.unifiedactionsheet
+
+import android.text.InputType
+import com.facebook.react.bridge.ReadableMap
+
+/// The subset of React Native's keyboardType values that map onto both
+/// platforms. Anything unrecognised falls back to the plain text keyboard.
+internal enum class PromptKeyboardType {
+  DEFAULT,
+  EMAIL_ADDRESS,
+  NUMERIC,
+  PHONE_PAD,
+  URL,
+  ;
+
+  fun toInputType(secure: Boolean): Int {
+    if (secure) {
+      // Keep the keyboard class: masking a passcode should still show digits.
+      return when (this) {
+        NUMERIC, PHONE_PAD ->
+          InputType.TYPE_CLASS_NUMBER or InputType.TYPE_NUMBER_VARIATION_PASSWORD
+        else -> InputType.TYPE_CLASS_TEXT or InputType.TYPE_TEXT_VARIATION_PASSWORD
+      }
+    }
+
+    return when (this) {
+      DEFAULT -> InputType.TYPE_CLASS_TEXT
+      EMAIL_ADDRESS -> InputType.TYPE_CLASS_TEXT or InputType.TYPE_TEXT_VARIATION_EMAIL_ADDRESS
+      NUMERIC -> InputType.TYPE_CLASS_NUMBER
+      PHONE_PAD -> InputType.TYPE_CLASS_PHONE
+      URL -> InputType.TYPE_CLASS_TEXT or InputType.TYPE_TEXT_VARIATION_URI
+    }
+  }
+
+  companion object {
+    fun fromWire(value: String?): PromptKeyboardType = when (value) {
+      "email-address" -> EMAIL_ADDRESS
+      "numeric" -> NUMERIC
+      "phone-pad" -> PHONE_PAD
+      "url" -> URL
+      else -> DEFAULT
+    }
+  }
+}
+
+internal data class PromptOptions(
+  val options: List<String>,
+  val cancelButtonIndex: Int?,
+  val destructiveButtonIndices: Set<Int>,
+  val disabledButtonIndices: Set<Int>,
+  val title: String?,
+  val message: String?,
+  val placeholder: String?,
+  val defaultValue: String?,
+  val keyboardType: PromptKeyboardType,
+  val secureTextEntry: Boolean,
+  val tintColor: String?,
+  val cancelButtonTintColor: String?,
+  val destructiveColor: String?,
+  val buttonTextAlignment: ButtonTextAlignment,
+  val userInterfaceStyle: ForcedAppearance,
+) {
+  /// The prompt reuses the sheet's content and dialog code, which are written
+  /// against ActionSheetOptions. Presentation is fixed to centered: UIKit has
+  /// no text field in an action sheet, so an anchored prompt has no iOS
+  /// counterpart and would break the "same options behave the same way" rule.
+  fun toSheetOptions(): ActionSheetOptions = ActionSheetOptions(
+    options = options,
+    cancelButtonIndex = cancelButtonIndex,
+    destructiveButtonIndices = destructiveButtonIndices,
+    title = title,
+    message = message,
+    tintColor = tintColor,
+    cancelButtonTintColor = cancelButtonTintColor,
+    destructiveColor = destructiveColor,
+    buttonTextAlignment = buttonTextAlignment,
+    disabledButtonIndices = disabledButtonIndices,
+    userInterfaceStyle = userInterfaceStyle,
+    presentationStyle = PresentationStyle.CENTERED,
+    anchorRect = null,
+    anchorAlignment = AnchorAlignment.START,
+  )
+
+  companion object {
+    fun fromReadableMap(map: ReadableMap): PromptOptions {
+      val labels = mutableListOf<String>()
+      map.getArray("options")?.let { array ->
+        for (index in 0 until array.size()) {
+          array.getString(index)?.let(labels::add)
+        }
+      }
+
+      return PromptOptions(
+        options = labels,
+        cancelButtonIndex = optInt(map, "cancelButtonIndex"),
+        destructiveButtonIndices = optIndices(map, "destructiveButtonIndices"),
+        disabledButtonIndices = optIndices(map, "disabledButtonIndices"),
+        title = optString(map, "title"),
+        message = optString(map, "message"),
+        placeholder = optString(map, "placeholder"),
+        defaultValue = optString(map, "defaultValue"),
+        keyboardType = PromptKeyboardType.fromWire(optString(map, "keyboardType")),
+        secureTextEntry = optBoolean(map, "secureTextEntry"),
+        tintColor = optString(map, "tintColor"),
+        cancelButtonTintColor = optString(map, "cancelButtonTintColor"),
+        destructiveColor = optString(map, "destructiveColor"),
+        buttonTextAlignment = ButtonTextAlignment.fromWire(optString(map, "buttonTextAlignment")),
+        userInterfaceStyle = ForcedAppearance.fromWire(optString(map, "userInterfaceStyle")),
+      )
+    }
+
+    private fun optIndices(map: ReadableMap, key: String): Set<Int> {
+      val indices = mutableSetOf<Int>()
+      map.getArray(key)?.let { array ->
+        for (index in 0 until array.size()) {
+          indices.add(array.getInt(index))
+        }
+      }
+
+      return indices
+    }
+
+    private fun optInt(map: ReadableMap, key: String): Int? =
+      if (map.hasKey(key) && !map.isNull(key)) map.getInt(key) else null
+
+    private fun optBoolean(map: ReadableMap, key: String): Boolean =
+      map.hasKey(key) && !map.isNull(key) && map.getBoolean(key)
+
+    private fun optString(map: ReadableMap, key: String): String? =
+      if (map.hasKey(key) && !map.isNull(key)) map.getString(key) else null
+  }
+}

package/android/src/main/java/com/unifiedactionsheet/SheetContentBuilder.kt

@@ -6,9 +6,11 @@ import android.util.TypedValue
 import android.view.Gravity
 import android.view.View
 import android.widget.Button
+import android.widget.EditText
 import android.widget.LinearLayout
 import android.widget.TextView
 import androidx.appcompat.content.res.AppCompatResources
+import androidx.appcompat.widget.AppCompatEditText
 import androidx.core.graphics.ColorUtils
 import androidx.core.view.AccessibilityDelegateCompat
 import androidx.core.view.ViewCompat
@@ -22,6 +24,8 @@ internal fun buildContent(
   options: ActionSheetOptions,
   palette: SheetPalette,
   includeCancelRow: Boolean = true,
+  /// Sits between the message and the rows. Only the prompt supplies one.
+  inputView: View? = null,
   onSelect: (Int) -> Unit,
 ): LinearLayout {
   val container = LinearLayout(context).apply {
@@ -36,6 +40,8 @@ internal fun buildContent(
     container.addView(buildHeader(context, it, palette.secondaryText, isTitle = false))
   }
 
+  inputView?.let(container::addView)
+
   val centerLabels = options.buttonTextAlignment == ButtonTextAlignment.CENTER
 
   val optionColor = parseColor(options.tintColor) ?: palette.primaryText
@@ -96,6 +102,31 @@ internal fun buildContent(
   return container
 }
 
+internal fun buildPromptInput(
+  context: Context,
+  options: PromptOptions,
+  palette: SheetPalette,
+): EditText = AppCompatEditText(context).apply {
+  setText(options.defaultValue.orEmpty())
+  hint = options.placeholder
+  setTextSize(TypedValue.COMPLEX_UNIT_SP, 16f)
+  setTextColor(palette.primaryText)
+  setHintTextColor(ColorUtils.setAlphaComponent(palette.secondaryText, DISABLED_TEXT_ALPHA))
+  setPadding(dp(context, 16), dp(context, 8), dp(context, 16), dp(context, 8))
+  isSingleLine = true
+  // After isSingleLine, never before: setSingleLine() installs
+  // SingleLineTransformationMethod, which replaces the password masking that
+  // setInputType() sets up. Ordering them the other way renders a secure field
+  // in plain text while still reporting a password input type.
+  inputType = options.keyboardType.toInputType(options.secureTextEntry)
+  // Land the caret after any default value rather than before it.
+  setSelection(text?.length ?: 0)
+  layoutParams = LinearLayout.LayoutParams(
+    LinearLayout.LayoutParams.MATCH_PARENT,
+    LinearLayout.LayoutParams.WRAP_CONTENT,
+  )
+}
+
 private fun buildHeader(
   context: Context,
   text: String,

package/android/src/main/java/com/unifiedactionsheet/SheetPresenters.kt

@@ -83,6 +83,60 @@ internal object CenteredDialogPresenter : SheetPresenter {
   }
 }
 
+/// The centered dialog with a text field above the buttons. Deliberately not a
+/// SheetPresenter: it takes PromptOptions and hands the field's text back with
+/// the index, which the sheet interface has no place for.
+internal fun buildPromptDialog(
+  activity: Activity,
+  options: PromptOptions,
+  onSelect: (Dialog, Int, String) -> Unit,
+): Pair<Dialog, () -> String> {
+  val isDark = isDarkAppearance(activity, options.userInterfaceStyle)
+  val palette = paletteFor(isDark)
+  val dialog = AppCompatDialog(activity, dialogTheme(isDark))
+  dialog.supportRequestWindowFeature(Window.FEATURE_NO_TITLE)
+
+  val context: Context = dialog.context
+  val input = buildPromptInput(context, options, palette)
+  val currentText = { input.text?.toString().orEmpty() }
+
+  val container = buildContent(
+    context = context,
+    options = options.toSheetOptions(),
+    palette = palette,
+    inputView = input,
+  ) { index -> onSelect(dialog, index, currentText()) }
+
+  dialog.setContentView(container)
+  dialog.setCanceledOnTouchOutside(true)
+
+  val background = GradientDrawable().apply {
+    cornerRadius = dp(context, PROMPT_CORNER_RADIUS_DP).toFloat()
+    setColor(palette.surface)
+  }
+  dialog.window?.setBackgroundDrawable(background)
+  container.background = background.constantState?.newDrawable() ?: background
+  container.clipToOutline = true
+
+  val metrics = context.resources.displayMetrics
+  val width = (metrics.widthPixels - 2 * dp(context, PROMPT_MARGIN_DP))
+    .coerceAtMost(dp(context, PROMPT_MAX_WIDTH_DP))
+    .coerceAtLeast(minOf(dp(context, PROMPT_MIN_WIDTH_DP), metrics.widthPixels))
+  dialog.window?.setLayout(width, WindowManager.LayoutParams.WRAP_CONTENT)
+
+  // A prompt exists to be typed into, so raise the keyboard with it rather than
+  // making the user tap the field first.
+  dialog.window?.setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_STATE_VISIBLE)
+  input.requestFocus()
+
+  return dialog to currentText
+}
+
+private const val PROMPT_CORNER_RADIUS_DP = 28
+private const val PROMPT_MARGIN_DP = 24
+private const val PROMPT_MIN_WIDTH_DP = 280
+private const val PROMPT_MAX_WIDTH_DP = 560
+
 internal class AnchoredDialogPresenter(private val anchorRect: Rect) : SheetPresenter {
   override fun build(
     activity: Activity,