@mrmeg/expo-ui 0.24.0 → 0.25.1

package/CHANGELOG.md

@@ -3,6 +3,64 @@
 All notable changes to `@mrmeg/expo-ui` are documented here. This project
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [0.25.1]
+
+### Fixed
+
+- **Android password toggles retain the native field.** The secure/plain Host
+  keys previously replaced the Compose field on every eye press, leaving the
+  keyboard visible but disconnecting subsequent typing. Android now changes
+  password transformation on one mounted Host/input/ref, preserving focus,
+  selection, and the input connection. iOS retains its two-field handoff.
+- **Non-scrolling drags no longer trigger tap-away dismissal.** `DismissKeyboard`
+  gives its boundary sole tap-dismiss ownership (`keyboardShouldPersistTaps="always"`)
+  instead of letting RN ScrollView independently blur a registered hosted field
+  on release. Both tap-away dismissal and text-surface focus check final travel
+  even when move events are missed, and cancel multitouch. Actual scrolling still
+  dismisses through the existing platform-specific scroll behavior.
+
+Consumer note: raw `Pressable` labels made from `StyledText` must set
+`selectable={false}`. On Android selectable label text can take native focus from
+an input even when the press handler does not dismiss. The template's auth
+controls and standalone scroll shell are corrected separately in app code;
+updating this package does not update a consuming app's copied forms.
+
+### Changed
+
+- **`spacing.radiusMd` is 10 instead of 12.** Buttons, inputs, selects, toggles,
+  tabs, menus, popovers, tooltips, list items and every other component on the
+  default radius render slightly squarer. `radiusSm` (8) and `radiusLg` (14) are
+  unchanged, so the scale still increases monotonically. Apps that want the old
+  look can pass `borderRadius: 12` through `setShape` or a `style` override.
+
+## [0.25.0]
+
+### Added
+
+- **The build emits a design-system manifest.** `dist/design-system.json`
+  (`schemaVersion: 1`) carries the spacing, radius and icon scales, the palette,
+  the theme colors, the font variants, and every component's variant and size
+  values, exported as `@mrmeg/expo-ui/design-system.json`.
+  `@mrmeg/eslint-plugin-expo-ui` loads it when the design-system sources are not
+  on disk, so the design-system rules work against an installed release instead
+  of only inside the template repo. Adding an export means the next release is a
+  minor bump.
+
+### Changed
+
+- **Peer ranges include Expo SDK 58.** `expo`, `expo-font`, `expo-haptics` and
+  `@expo/ui` now accept `>=56 <59` (58 pre-releases included), `react-native`
+  accepts `>=0.85 <0.89` (0.88 release candidates included), and
+  `react-native-gesture-handler` accepts `>=2.30 <4`. SDK 56 and 57 apps stay
+  in range; nothing else about the install changes for them.
+- **`StatusBar` no longer sets an Android background color or translucency.**
+  React Native 0.88 removed `backgroundColor`, `translucent` and their setters.
+  Edge-to-edge has been mandatory since SDK 54, under which the bar was already
+  transparent and translucent, so this is a no-op on every supported SDK. The
+  component now only applies the theme-driven bar style.
+
 ## [0.24.0]
 
 ### Fixed

package/LLM_USAGE.md

@@ -24,7 +24,8 @@ Importable paths: root, `components`, `components/*`, `constants`,
 `constants/*`, `hooks`, `hooks/*`, `state`, `state/*`, `lib`. Never import from
 `@mrmeg/expo-ui/dist/*` or a source checkout path.
 
-Hosts: Expo 56–57, React 19.2, React Native 0.85–0.86, React Native Web 0.21.
+Hosts: Expo 56–58 (58 in beta), React 19.2, React Native 0.85–0.88, React
+Native Web 0.21.
 Install the peer versions recommended by the consuming app's Expo SDK.
 
 ## Required App Setup
@@ -73,6 +74,13 @@ avoidance is `react-native-keyboard-controller`, so mount its `KeyboardProvider`
 above `UIProvider`; use `KeyboardAvoidingView` directly only for a subtree with
 custom behavior.
 
+`DismissKeyboard` owns tap dismissal; its ScrollView uses
+`keyboardShouldPersistTaps="always"` so RN cannot independently blur a hosted
+field after a non-scrolling drag. Use `always` for your own scroll view inside
+that boundary too. Dead-space taps dismiss on release; movement and multitouch
+cancel. Actual scrolling retains platform-specific dismissal. Submit handlers
+call `dismissKeyboard()` explicitly.
+
 `BottomSheet` renders the platform's native sheet through `@expo/ui` (iOS
 SwiftUI `.sheet()`, Android Material3 `ModalBottomSheet`, web `vaul`). The
 platform owns gestures and keyboard avoidance: `swipeEnabled`, `avoidKeyboard`,
@@ -184,6 +192,18 @@ faces through `expo-font` / `@expo-google-fonts`, `"numeric"` (default) for one
 multi-weight CSS family. `setShape({ button: { borderRadius?, withShadow? } })`
 re-shapes Buttons globally. Per-instance props and caller `style` always win.
 
+Enforce these rules mechanically with `@mrmeg/eslint-plugin-expo-ui`
+(`bun add -d @mrmeg/eslint-plugin-expo-ui`), which reports raw colors, off-scale
+spacing and radius, appearance overrides on package components, and raw
+primitives as ESLint diagnostics. It reads this package's
+`design-system.json` manifest out of `node_modules`, so the messages quote the
+tokens, presets and sizes of the installed release. The plugin's first npm release is
+still pending, and only `@mrmeg/expo-ui` releases built after the manifest was
+added ship one: the installed release has it when
+`node_modules/@mrmeg/expo-ui/dist/design-system.json` exists. Config block and
+settings:
+https://raw.githubusercontent.com/mrmeg/expo-template/main/packages/lint/README.md
+
 ## Component Use-Case Index
 
 Check this before creating a new app-local primitive. All components come from
@@ -242,6 +262,11 @@ Check this before creating a new app-local primitive. All components come from
 `BodyText`, `CaptionText`, `LabelText`, `EyebrowText`, `MonoText`, `SerifText`,
 `SansSerifText`, `SerifBoldText`, `SansSerifBoldText`.
 
+Set `selectable={false}` on text labels inside app-owned `Pressable`s. Selectable
+Android text can take input focus even if the press handler never dismisses the
+keyboard. Package controls already scope label selectability; ordinary text
+should remain selectable.
+
 ## Component Selection Rules
 
 - `Button` commands · `Toggle` one pressed state · `ToggleGroup` a related set · `Switch` binary settings · `RadioGroup` few exclusive choices · `Select` longer option sets.

package/README.md

@@ -9,13 +9,24 @@ Read `node_modules/@mrmeg/expo-ui/llms.txt` first, then `LLM_USAGE.md` (concise
 rules) or `llms-full.md` (expanded contract), before creating app-local UI
 primitives. All three ship in the npm tarball.
 
+The same rules are available as an ESLint plugin: `@mrmeg/eslint-plugin-expo-ui`
+turns the theme and text rules into diagnostics at the call site — raw colors,
+off-scale spacing and radius, appearance overrides on package components, and raw
+primitives that have a wrapper here. See [`../lint/README.md`](../lint/README.md)
+for the config block. It reads the design-system facts from
+`@mrmeg/expo-ui/design-system.json`, the manifest this package's build ships, so
+the diagnostics quote the tokens, presets and sizes of the installed release. The
+plugin's first npm release is still pending, and only `@mrmeg/expo-ui` releases
+built after the manifest was added ship it: the installed release has one when
+`node_modules/@mrmeg/expo-ui/dist/design-system.json` exists.
+
 ## Install
 
 ```sh
 bun add @mrmeg/expo-ui
 ```
 
-Tested hosts: Expo SDK 56–57, React 19.2, React Native 0.85–0.86, React Native
+Tested hosts: Expo SDK 56–58 (58 in beta), React 19.2, React Native 0.85–0.88, React Native
 Web 0.21. Install these peers at the versions your Expo SDK recommends: `expo`,
 `@expo/ui`, `expo-font`, `expo-haptics`, `react`, `react-native`,
 `react-native-web`, `react-native-gesture-handler`,
@@ -99,6 +110,20 @@ For a subtree with custom keyboard behavior, use `KeyboardAvoidingView`
 directly (`behavior`, `automaticOffset`, `contentContainerStyle`,
 `keyboardVerticalOffset`).
 
+### Keyboard dismissal
+
+`DismissKeyboard` owns tap-away dismissal without claiming touches. Its scroll
+view uses `keyboardShouldPersistTaps="always"`: RN's `handled` policy can blur
+Expo-hosted fields independently when a finger travels without scrolling.
+Single-finger dead-space taps dismiss on release; movement past 10 logical units
+and multitouch cancel the tap. Real scrolling still dismisses (interactive on
+iOS, an explicit scroll-begin handler on Android).
+
+If a form supplies its own ScrollView inside `DismissKeyboard scrollable={false}`
+or an app-level `useKeyboardDismissResponder` boundary, use `always` there too.
+Avoid nested keyboard-avoiding wrappers; the package reuses `UIProvider`'s owner.
+Call `dismissKeyboard()` explicitly from submit handlers.
+
 ## Theme System
 
 ```tsx
@@ -199,7 +224,7 @@ too, because @react-navigation parses them with a color library.
 
 `spacing` exposes an 8px base scale (`xxs` 2, `xs` 4, `sm` 8, `smd` 12, `md`
 16, `mdl` 20, `lg` 24, `xl` 32, `xxl` 48, `xxxl` 64), radii (`radiusNone` 0,
-`radiusXs` 4, `radiusSm` 8, `radiusMd` 12, `radiusLg` 14, `radiusXl` 18,
+`radiusXs` 4, `radiusSm` 8, `radiusMd` 10, `radiusLg` 14, `radiusXl` 18,
 `radius2xl` 24, `radiusFull` 9999), icon sizes (`iconXs` 12, `iconSm` 16,
 `iconMd` 24, `iconLg` 32, `iconXl` 48), and the semantic density tokens package
 components read from. Prefer the semantic names so a density tune lands
@@ -289,6 +314,10 @@ import { BodyText, CaptionText, HeadingText, StyledText } from "@mrmeg/expo-ui/c
 - `selectable`: defaults to `true`; package controls disable it for labels and
   interactive chrome where accidental drag selection would feel broken.
 
+For app-owned `Pressable` labels, explicitly set `selectable={false}` on the
+nested `StyledText`. On Android selectable label text can take focus and the IME
+connection from an active input. Preserve selection for ordinary readable text.
+
 Aliases: `DisplayText`, `TitleText`, `HeadingText`, `SubheadingText`,
 `BodyText`, `CaptionText`, `LabelText`, `EyebrowText`, `MonoText` (code, IDs,
 tabular figures), `SerifText`, `SansSerifText`, `SerifBoldText`,
@@ -656,3 +685,18 @@ inspected before release. `ui:consumer-smoke` installs the packed tarball into
 a clean fixture, checks every documented export-map target resolves,
 type-checks all public entrypoints, and runs an iOS `expo export` against the
 packed package at the workspace's Expo version, without a custom Metro config.
+
+### Design-system manifest
+
+`ui:build` also writes `dist/design-system.json`
+([`scripts/build-design-system-manifest.mjs`](../../scripts/build-design-system-manifest.mjs)):
+the spacing, radius and icon scales, the palette, the light and dark themes, the
+font variants, and every component's variant and size values, serialized out of
+`src` by the same extractor the lint rules use. It is exported as
+`@mrmeg/expo-ui/design-system.json`, and `@mrmeg/eslint-plugin-expo-ui` reads it
+in projects that install this package instead of checking out its sources — which
+is what lets the design-system rules quote this release's presets and tokens.
+`ui:consumer-smoke` asserts the packed tarball carries it and that it parses at
+`schemaVersion: 1` with a non-empty component list. The build fails rather than
+writing an empty manifest, so a broken extractor cannot ship as "no rules to
+enforce".

package/dist/components/Avatar.js

@@ -81,12 +81,17 @@ export function getAvatarInitials(name) {
  * `{ bundle, name }`, a resolved asset object). Keying those as "no image"
  * silently degraded a perfectly good source to initials.
  */
+// `Array.isArray` narrows to `any[]`, which cannot subtract the readonly array
+// arm of the source union, so the predicate spells the arm out.
+function isSourceList(source) {
+    return Array.isArray(source);
+}
 function getSourceKey(source) {
     if (source == null)
         return null;
     if (typeof source === "number")
         return `asset:${source}`;
-    if (Array.isArray(source)) {
+    if (isSourceList(source)) {
         // An empty array carries no image; anything else does.
         const keys = source.map((entry) => getSourceKey(entry) ?? "").filter(Boolean);
         return keys.length > 0 ? keys.join("|") : null;

package/dist/components/Button.d.ts

@@ -40,7 +40,7 @@ export interface ButtonProps extends PressableProps {
      */
     txOptions?: TextProps["txOptions"];
     /**
-     * An optional style override useful for padding & margin.
+     * An optional style override useful for margin and layout.
      */
     style?: StyleProp<ViewStyle>;
     /**

package/dist/components/Carousel.js

@@ -94,6 +94,8 @@ export function Carousel({ children, itemWidth = 0.85, gap = spacing.md, content
     // state: web's throttled ticks report the same page many times over, and
     // onIndexChange must fire once per page.
     const activeIndexRef = useRef(activeIndex);
+    // `ComponentRef<typeof ScrollView>` rather than RN 0.88's `ScrollViewInstance`,
+    // which RN 0.85/0.86 typings do not export.
     const scrollRef = useRef(null);
     const hasScrolledToInitial = useRef(false);
     const commitIndex = useCallback((next) => {

package/dist/components/Dialog.d.ts

@@ -1,25 +1,9 @@
 import * as React from "react";
-import { View, ViewProps } from "react-native";
+import { ViewProps } from "react-native";
 import * as DialogPrimitive from "@rn-primitives/dialog";
 import * as AlertDialogPrimitive from "@rn-primitives/alert-dialog";
-declare const DialogTrigger: {
-    ({ asChild, onPress: onPressProp, disabled, ref, ...props }: Omit<import("react-native").PressableProps & React.RefAttributes<View>, "ref"> & {
-        asChild?: boolean;
-    } & {
-        onKeyDown?: (ev: React.KeyboardEvent) => void;
-        onKeyUp?: (ev: React.KeyboardEvent) => void;
-    } & React.RefAttributes<View>): React.JSX.Element;
-    displayName: string;
-};
-declare const DialogClose: {
-    ({ asChild, onPress: onPressProp, disabled, ref, ...props }: Omit<import("react-native").PressableProps & React.RefAttributes<View>, "ref"> & {
-        asChild?: boolean;
-    } & {
-        onKeyDown?: (ev: React.KeyboardEvent) => void;
-        onKeyUp?: (ev: React.KeyboardEvent) => void;
-    } & React.RefAttributes<View>): React.JSX.Element;
-    displayName: string;
-};
+declare const DialogTrigger: typeof DialogPrimitive.Trigger;
+declare const DialogClose: typeof DialogPrimitive.Close;
 interface DialogProps extends DialogPrimitive.RootProps {
     children: React.ReactNode;
 }
@@ -36,58 +20,19 @@ declare function DialogTitle({ children, style, ...props }: DialogPrimitive.Titl
 declare function DialogDescription({ children, style, ...props }: DialogPrimitive.DescriptionProps & {
     children: React.ReactNode;
 }): React.JSX.Element;
-declare const Dialog: typeof DialogRoot & {
-    Trigger: {
-        ({ asChild, onPress: onPressProp, disabled, ref, ...props }: Omit<import("react-native").PressableProps & React.RefAttributes<View>, "ref"> & {
-            asChild?: boolean;
-        } & {
-            onKeyDown?: (ev: React.KeyboardEvent) => void;
-            onKeyUp?: (ev: React.KeyboardEvent) => void;
-        } & React.RefAttributes<View>): React.JSX.Element;
-        displayName: string;
-    };
+type DialogComponent = typeof DialogRoot & {
+    Trigger: typeof DialogTrigger;
     Content: typeof DialogContent;
     Header: typeof DialogHeader;
     Footer: typeof DialogFooter;
     Title: typeof DialogTitle;
     Description: typeof DialogDescription;
-    Close: {
-        ({ asChild, onPress: onPressProp, disabled, ref, ...props }: Omit<import("react-native").PressableProps & React.RefAttributes<View>, "ref"> & {
-            asChild?: boolean;
-        } & {
-            onKeyDown?: (ev: React.KeyboardEvent) => void;
-            onKeyUp?: (ev: React.KeyboardEvent) => void;
-        } & React.RefAttributes<View>): React.JSX.Element;
-        displayName: string;
-    };
-};
-declare const AlertDialogTrigger: {
-    ({ asChild, onPress: onPressProp, disabled, ref, ...props }: Omit<import("react-native").PressableProps & React.RefAttributes<View>, "ref"> & {
-        asChild?: boolean;
-    } & {
-        onKeyDown?: (ev: React.KeyboardEvent) => void;
-        onKeyUp?: (ev: React.KeyboardEvent) => void;
-    } & React.RefAttributes<View>): React.JSX.Element;
-    displayName: string;
-};
-declare const AlertDialogAction: {
-    ({ asChild, onPress: onPressProp, disabled, ref, ...props }: Omit<import("react-native").PressableProps & React.RefAttributes<View>, "ref"> & {
-        asChild?: boolean;
-    } & {
-        onKeyDown?: (ev: React.KeyboardEvent) => void;
-        onKeyUp?: (ev: React.KeyboardEvent) => void;
-    } & React.RefAttributes<View>): React.JSX.Element;
-    displayName: string;
-};
-declare const AlertDialogCancel: {
-    ({ asChild, onPress: onPressProp, disabled, ref, ...props }: Omit<import("react-native").PressableProps & React.RefAttributes<View>, "ref"> & {
-        asChild?: boolean;
-    } & {
-        onKeyDown?: (ev: React.KeyboardEvent) => void;
-        onKeyUp?: (ev: React.KeyboardEvent) => void;
-    } & React.RefAttributes<View>): React.JSX.Element;
-    displayName: string;
+    Close: typeof DialogClose;
 };
+declare const Dialog: DialogComponent;
+declare const AlertDialogTrigger: typeof AlertDialogPrimitive.Trigger;
+declare const AlertDialogAction: typeof AlertDialogPrimitive.Action;
+declare const AlertDialogCancel: typeof AlertDialogPrimitive.Cancel;
 interface AlertDialogProps extends AlertDialogPrimitive.RootProps {
     children: React.ReactNode;
 }
@@ -102,39 +47,16 @@ declare function AlertDialogTitle({ children, style, ...props }: AlertDialogPrim
 declare function AlertDialogDescription({ children, style, ...props }: AlertDialogPrimitive.DescriptionProps & {
     children: React.ReactNode;
 }): React.JSX.Element;
-declare const AlertDialog: typeof AlertDialogRoot & {
-    Trigger: {
-        ({ asChild, onPress: onPressProp, disabled, ref, ...props }: Omit<import("react-native").PressableProps & React.RefAttributes<View>, "ref"> & {
-            asChild?: boolean;
-        } & {
-            onKeyDown?: (ev: React.KeyboardEvent) => void;
-            onKeyUp?: (ev: React.KeyboardEvent) => void;
-        } & React.RefAttributes<View>): React.JSX.Element;
-        displayName: string;
-    };
+type AlertDialogComponent = typeof AlertDialogRoot & {
+    Trigger: typeof AlertDialogTrigger;
     Content: typeof AlertDialogContent;
     Header: typeof DialogHeader;
     Footer: typeof DialogFooter;
     Title: typeof AlertDialogTitle;
     Description: typeof AlertDialogDescription;
-    Action: {
-        ({ asChild, onPress: onPressProp, disabled, ref, ...props }: Omit<import("react-native").PressableProps & React.RefAttributes<View>, "ref"> & {
-            asChild?: boolean;
-        } & {
-            onKeyDown?: (ev: React.KeyboardEvent) => void;
-            onKeyUp?: (ev: React.KeyboardEvent) => void;
-        } & React.RefAttributes<View>): React.JSX.Element;
-        displayName: string;
-    };
-    Cancel: {
-        ({ asChild, onPress: onPressProp, disabled, ref, ...props }: Omit<import("react-native").PressableProps & React.RefAttributes<View>, "ref"> & {
-            asChild?: boolean;
-        } & {
-            onKeyDown?: (ev: React.KeyboardEvent) => void;
-            onKeyUp?: (ev: React.KeyboardEvent) => void;
-        } & React.RefAttributes<View>): React.JSX.Element;
-        displayName: string;
-    };
+    Action: typeof AlertDialogAction;
+    Cancel: typeof AlertDialogCancel;
 };
+declare const AlertDialog: AlertDialogComponent;
 export { Dialog, DialogTrigger, DialogContent, DialogHeader, DialogFooter, DialogTitle, DialogDescription, DialogClose, AlertDialog, AlertDialogTrigger, AlertDialogContent, AlertDialogTitle, AlertDialogDescription, AlertDialogAction, AlertDialogCancel, };
 export type { DialogProps, DialogContentProps, AlertDialogProps, AlertDialogContentProps, };

package/dist/components/Dialog.js

@@ -14,6 +14,11 @@ const FullWindowOverlay = Platform.OS === "ios" ? RNFullWindowOverlay : React.Fr
 // ============================================================================
 // Dialog
 // ============================================================================
+// These re-exports and the compound components below carry explicit type
+// annotations because React Native 0.88 resolves primitive ref types through
+// its private `ReactNativeElement`, which declaration emit cannot name
+// portably (TS2883). Annotating with `typeof <primitive>` keeps the emitted
+// .d.ts pointing at the primitive's own public types instead.
 const DialogTrigger = DialogPrimitive.Trigger;
 const DialogClose = DialogPrimitive.Close;
 function DialogRoot({ children, ...props }) {

package/dist/components/DismissKeyboard.d.ts

@@ -12,15 +12,17 @@ type Props = {
  * Wrapper for a screen (or form) that dismisses the keyboard when the user taps
  * outside of a text input.
  *
- * Mirrors RN's `keyboardShouldPersistTaps="handled"` for the native `@expo/ui`
- * field, which RN itself cannot see: the wrapper never claims the touch, so
- * buttons, other fields and the focused field's own gestures win, and it
- * dismisses on release only when nothing else took the tap and the finger did
- * not scroll. See `useKeyboardDismissResponder`.
+ * The wrapper never claims the touch: buttons, other fields and the focused
+ * field's own gestures win. It dismisses only an unclaimed single-finger tap
+ * within the travel slop, even if no scroll/move event was delivered. The inner
+ * ScrollView uses `always` to leave tap dismissal to this boundary; RN's
+ * `handled` policy can independently blur registered hosted inputs on release
+ * after a drag that produced no scroll. See `useKeyboardDismissResponder`.
  *
  * A drag on the inner ScrollView also hides the keyboard: `interactive` on iOS
  * (UIKit resigns any first responder, SwiftUI fields included) and an explicit
- * dismiss on drag start on Android, where RN's `on-drag` only knows RN inputs.
+ * dismiss on drag start on Android, using the package's window-independent
+ * native blur handle with a keyboard-controller fallback.
  */
 export declare function DismissKeyboard({ children, style, avoidKeyboard, scrollable, }: Props): React.JSX.Element;
 export {};

package/dist/components/DismissKeyboard.js

@@ -6,20 +6,22 @@ import { dismissKeyboard, useKeyboardDismissResponder } from "./keyboardDismiss.
  * Wrapper for a screen (or form) that dismisses the keyboard when the user taps
  * outside of a text input.
  *
- * Mirrors RN's `keyboardShouldPersistTaps="handled"` for the native `@expo/ui`
- * field, which RN itself cannot see: the wrapper never claims the touch, so
- * buttons, other fields and the focused field's own gestures win, and it
- * dismisses on release only when nothing else took the tap and the finger did
- * not scroll. See `useKeyboardDismissResponder`.
+ * The wrapper never claims the touch: buttons, other fields and the focused
+ * field's own gestures win. It dismisses only an unclaimed single-finger tap
+ * within the travel slop, even if no scroll/move event was delivered. The inner
+ * ScrollView uses `always` to leave tap dismissal to this boundary; RN's
+ * `handled` policy can independently blur registered hosted inputs on release
+ * after a drag that produced no scroll. See `useKeyboardDismissResponder`.
  *
  * A drag on the inner ScrollView also hides the keyboard: `interactive` on iOS
  * (UIKit resigns any first responder, SwiftUI fields included) and an explicit
- * dismiss on drag start on Android, where RN's `on-drag` only knows RN inputs.
+ * dismiss on drag start on Android, using the package's window-independent
+ * native blur handle with a keyboard-controller fallback.
  */
 export function DismissKeyboard({ children, style, avoidKeyboard = true, scrollable = true, }) {
     const responderProps = useKeyboardDismissResponder();
     const hasKeyboardAvoidance = useKeyboardAvoidance();
-    const content = scrollable ? (_jsx(ScrollView, { style: { flex: 1 }, contentContainerStyle: { flexGrow: 1, justifyContent: "center" }, keyboardShouldPersistTaps: "handled", keyboardDismissMode: Platform.OS === "ios" ? "interactive" : "none", onScrollBeginDrag: Platform.OS === "android" ? dismissKeyboard : undefined, showsVerticalScrollIndicator: false, children: children })) : (children);
+    const content = scrollable ? (_jsx(ScrollView, { style: { flex: 1 }, contentContainerStyle: { flexGrow: 1, justifyContent: "center" }, keyboardShouldPersistTaps: "always", keyboardDismissMode: Platform.OS === "ios" ? "interactive" : "none", onScrollBeginDrag: Platform.OS === "android" ? dismissKeyboard : undefined, showsVerticalScrollIndicator: false, children: children })) : (children);
     if (!avoidKeyboard || hasKeyboardAvoidance) {
         return (_jsx(View, { style: { flex: 1 }, ...responderProps, children: content }));
     }

package/dist/components/DropdownMenu.d.ts

@@ -1,40 +1,11 @@
 import * as React from "react";
-import { type TextStyle, View } from "react-native";
+import { type TextStyle } from "react-native";
 import * as DropdownMenuPrimitive from "@rn-primitives/dropdown-menu";
-declare const DropdownMenu: {
-    ({ asChild, onOpenChange: onOpenChangeProp, ref, ...viewProps }: import("react-native").ViewProps & {
-        asChild?: boolean;
-    } & {
-        onOpenChange?: (open: boolean) => void;
-    } & React.RefAttributes<View>): React.JSX.Element;
-    displayName: string;
-};
-declare const DropdownMenuGroup: {
-    ({ asChild, ref, ...props }: import("react-native").ViewProps & {
-        asChild?: boolean;
-    } & React.RefAttributes<View>): React.JSX.Element;
-    displayName: string;
-};
+declare const DropdownMenu: typeof DropdownMenuPrimitive.Root;
+declare const DropdownMenuGroup: typeof DropdownMenuPrimitive.Group;
 declare const DropdownMenuPortal: typeof DropdownMenuPrimitive.Portal;
-declare const DropdownMenuSub: {
-    ({ asChild, defaultOpen, open: openProp, onOpenChange: onOpenChangeProp, ref, ...props }: import("react-native").ViewProps & {
-        asChild?: boolean;
-    } & {
-        defaultOpen?: boolean;
-        open?: boolean;
-        onOpenChange?: (value: boolean) => void;
-    } & React.RefAttributes<View>): React.JSX.Element;
-    displayName: string;
-};
-declare const DropdownMenuRadioGroup: {
-    ({ asChild, value, onValueChange, ref, ...props }: import("react-native").ViewProps & {
-        asChild?: boolean;
-    } & {
-        value: string | undefined;
-        onValueChange: (value: string) => void;
-    } & React.RefAttributes<View>): React.JSX.Element;
-    displayName: string;
-};
+declare const DropdownMenuSub: typeof DropdownMenuPrimitive.Sub;
+declare const DropdownMenuRadioGroup: typeof DropdownMenuPrimitive.RadioGroup;
 /**
  * DropdownMenuTrigger Component
  * Wraps the primitive Trigger to default `accessibilityRole="button"`.

package/dist/components/DropdownMenu.js

@@ -10,7 +10,8 @@ import { useScalePress } from "../hooks/useScalePress.js";
 import * as DropdownMenuPrimitive from "@rn-primitives/dropdown-menu";
 import { FullWindowOverlay as RNFullWindowOverlay } from "react-native-screens";
 import { useSafeAreaInsets } from "react-native-safe-area-context";
-// Re-export primitives that don't need styling
+// Re-export primitives that don't need styling. Annotated with `typeof` for
+// portable declaration emit — see the note in Dialog.tsx (TS2883).
 const DropdownMenu = DropdownMenuPrimitive.Root;
 const DropdownMenuGroup = DropdownMenuPrimitive.Group;
 const DropdownMenuPortal = DropdownMenuPrimitive.Portal;

package/dist/components/InputOTP.js

@@ -27,6 +27,8 @@ const BULLET = "\u2022";
  */
 function InputOTP({ length = 6, value = "", onChangeText, onComplete, error = false, errorText, disabled = false, autoFocus = false, secureTextEntry = false, inputMode = "numeric", style: styleOverride, }) {
     const { theme } = useTheme();
+    // `ComponentRef<typeof RNTextInput>` rather than RN 0.88's `TextInputInstance`,
+    // which RN 0.85/0.86 typings do not export.
     const inputRef = useRef(null);
     const [focused, setFocused] = useState(false);
     const styles = themedStyles(theme);

package/dist/components/Popover.d.ts

@@ -1,6 +1,6 @@
 import * as PopoverPrimitive from "@rn-primitives/popover";
 import * as React from "react";
-import { View, ViewProps } from "react-native";
+import { ViewProps } from "react-native";
 /**
  * Popover Trigger Component
  * The element that triggers the popover to open/close
@@ -44,21 +44,21 @@ interface PopoverFooterProps extends ViewProps {
 }
 declare function PopoverFooter({ children, style, ...props }: PopoverFooterProps): React.JSX.Element;
 /**
- * Popover Component with Sub-components
- * Properly typed interface for dot notation access (e.g., Popover.Trigger)
+ * Popover Root Component
+ * Manages popover state and provides context for trigger and content
  */
-declare const Popover: {
-    ({ asChild, onOpenChange: onOpenChangeProp, ref, ...viewProps }: ViewProps & {
-        asChild?: boolean;
-    } & {
-        onOpenChange?: (open: boolean) => void;
-    } & React.RefAttributes<View>): React.JSX.Element;
-    displayName: string;
-} & {
+declare const PopoverRoot: typeof PopoverPrimitive.Root;
+type PopoverComponent = typeof PopoverRoot & {
     Trigger: typeof PopoverTrigger;
     Content: typeof PopoverContent;
     Header: typeof PopoverHeader;
     Body: typeof PopoverBody;
     Footer: typeof PopoverFooter;
 };
+/**
+ * Popover Component with Sub-components
+ * Properly typed interface for dot notation access (e.g., Popover.Trigger).
+ * The annotation is what keeps declaration emit portable — see Dialog.tsx (TS2883).
+ */
+declare const Popover: PopoverComponent;
 export { Popover, PopoverTrigger, PopoverContent, PopoverHeader, PopoverBody, PopoverFooter, };

package/dist/components/Popover.js

@@ -40,7 +40,7 @@ function PopoverContent({ side, align = "center", sideOffset = 4, portalHost, ..
             padding: spacing.xs,
             ...getShadowStyle("soft"),
         },
-    ]);
+    ]) ?? undefined;
     return (_jsx(PopoverPrimitive.Portal, { hostName: portalHost, children: _jsx(FullWindowOverlay, { children: _jsx(PopoverPrimitive.Overlay, { style: Platform.select({ native: StyleSheet.absoluteFill }), children: _jsx(AnimatedView, { type: "fade", enterDuration: 200, children: _jsx(TextColorContext.Provider, { value: textColor, children: _jsx(TextClassContext.Provider, { value: "", children: _jsx(PopoverPrimitive.Content, { side: side, align: align, sideOffset: sideOffset, style: contentStyle, ...props }) }) }) }) }) }) }));
 }
 function PopoverHeader({ children, style, ...props }) {
@@ -83,7 +83,8 @@ function PopoverFooter({ children, style, ...props }) {
 const PopoverRoot = PopoverPrimitive.Root;
 /**
  * Popover Component with Sub-components
- * Properly typed interface for dot notation access (e.g., Popover.Trigger)
+ * Properly typed interface for dot notation access (e.g., Popover.Trigger).
+ * The annotation is what keeps declaration emit portable — see Dialog.tsx (TS2883).
  */
 const Popover = Object.assign(PopoverRoot, {
     Trigger: PopoverTrigger,

package/dist/components/Select.d.ts

@@ -1,6 +1,10 @@
 import * as React from "react";
-import { View } from "react-native";
 import * as SelectPrimitive from "@rn-primitives/select";
+/**
+ * SelectRoot Component
+ * Manages select state and provides context for trigger and content
+ */
+declare const SelectRoot: typeof SelectPrimitive.Root;
 /**
  * Size variants for SelectTrigger
  */
@@ -57,25 +61,7 @@ declare function SelectLabel({ style: styleOverride, ...props }: SelectLabelProp
  */
 type SelectSeparatorProps = SelectPrimitive.SeparatorProps;
 declare function SelectSeparator({ style: styleOverride, ...props }: SelectSeparatorProps): React.JSX.Element;
-/**
- * Select Component with Sub-components
- * Properly typed interface for dot notation access (e.g., Select.Trigger)
- */
-declare const Select: {
-    ({ asChild, value: valueProp, defaultValue, onValueChange: onValueChangeProp, onOpenChange: onOpenChangeProp, disabled, ref, ...viewProps }: import("react-native").ViewProps & {
-        asChild?: boolean;
-    } & {
-        value?: import("@rn-primitives/select").Option;
-        defaultValue?: import("@rn-primitives/select").Option;
-        onValueChange?: (option: import("@rn-primitives/select").Option) => void;
-        onOpenChange?: (open: boolean) => void;
-        disabled?: boolean;
-        dir?: "ltr" | "rtl";
-        name?: string;
-        required?: boolean;
-    } & React.RefAttributes<View>): React.JSX.Element;
-    displayName: string;
-} & {
+type SelectComponent = typeof SelectRoot & {
     Trigger: typeof SelectTrigger;
     Value: typeof SelectValue;
     Content: typeof SelectContent;
@@ -84,5 +70,11 @@ declare const Select: {
     Label: typeof SelectLabel;
     Separator: typeof SelectSeparator;
 };
+/**
+ * Select Component with Sub-components
+ * Properly typed interface for dot notation access (e.g., Select.Trigger).
+ * The annotation is what keeps declaration emit portable — see Dialog.tsx (TS2883).
+ */
+declare const Select: SelectComponent;
 export { Select, SelectTrigger, SelectValue, SelectContent, SelectItem, SelectGroup, SelectLabel, SelectSeparator, };
 export type { SelectSize, SelectTriggerProps, SelectValueProps, SelectContentProps, SelectItemProps, SelectGroupProps, SelectLabelProps, SelectSeparatorProps, };

package/dist/components/Select.js

@@ -210,7 +210,8 @@ const styles = StyleSheet.create({
 });
 /**
  * Select Component with Sub-components
- * Properly typed interface for dot notation access (e.g., Select.Trigger)
+ * Properly typed interface for dot notation access (e.g., Select.Trigger).
+ * The annotation is what keeps declaration emit portable — see Dialog.tsx (TS2883).
  */
 const Select = Object.assign(SelectRoot, {
     Trigger: SelectTrigger,