react-native-tinyui 1.0.0 → 1.1.1

package/README.md

@@ -1,16 +1,47 @@
+<img src="./assets/banner.png" alt="TinyUI — Native iOS components for React Native" width="100%" />
+
 # react-native-tinyui
 
-Dependency-free, native iOS `Menu`, `Popover`, `TipKit`, `Stepper`, `ConcentricView`, `SFSymbol` and `LiquidGlassText` components for React Native's
-New Architecture. The public API follows normal React composition patterns;
-the native UI is exposed through Fabric components. `Menu`, `Popover`, `Stepper`, `ConcentricView` and `SFSymbol` are
-implemented directly with UIKit; `LiquidGlassText` uses SwiftUI where needed.
+A dependency-free collection of native iOS components for React Native's New
+Architecture. Built on Fabric, TinyUI offers familiar React composition while
+staying close to native APIs. It uses UIKit by default and SwiftUI where needed.
+
+## Components
+
+| Component                          | What it does                                                   |
+| ---------------------------------- | -------------------------------------------------------------- |
+| [Menu](#menu)                      | Present native menus with actions, submenus, and sections       |
+| [Popover](#popover)                | Show interactive React Native content in a native popover      |
+| [TipKit](#tipkit)                  | Present contextual tips using Apple's TipKit framework         |
+| [LiquidGlassText](#liquidglasstext) | Render text with native glass effects inside the glyphs        |
+| [Stepper](#stepper)                | Adjust numeric values with the native iOS stepper              |
+| [ConcentricView](#concentricview)  | Follow the containing view's corners with concentric rounding   |
+| [SFSymbol](#sfsymbol)              | Display SF Symbols with native rendering and animation effects |
+
+Screenshots below show the example app on an iPhone 17 Pro simulator running
+iOS 26.5.
+
+## Philosophy and comparison with `@expo/ui`
+
+TinyUI prioritizes performance, stability, a small app footprint, and familiar
+React composition. These priorities guide which components we add and how we
+bridge them.
 
-The initial component behavior is inspired by
-[`@expo/ui`](https://github.com/expo/expo/tree/main/packages/expo-ui), but this
-package does not require Expo Modules or any other runtime package. The
-React Native ↔ native view integration follows the approach used by
-[`react-native-pager-view`](https://github.com/callstack/react-native-pager-view):
-a Fabric component owns the platform view that renders its content.
+| Design choice | `react-native-tinyui` | `@expo/ui` |
+| --- | --- | --- |
+| Runtime dependencies | Zero additional runtime dependencies beyond `react` and `react-native`. No `expo`, Expo Modules, or `react-native-nitro-modules` required. | Uses Expo Modules; existing React Native apps must [install `expo`](https://docs.expo.dev/versions/latest/sdk/ui/swift-ui/#installation). |
+| Native implementation | Performance and stability first. Prefers direct UIKit integration through Fabric; uses SwiftUI when a component needs it. | Uses [SwiftUI on iOS](https://docs.expo.dev/versions/latest/sdk/ui/swift-ui/), with its layout and hosting model. |
+| Selective inclusion and app size | Component-specific JS imports avoid loading unrelated component modules. An explicit native component list excludes unselected UI implementations and their framework requirements from the pod. | Provides platform-specific JS entry points. Its [iOS podspec](https://github.com/expo/expo/blob/main/packages/expo-ui/ios/ExpoUI.podspec) includes native sources together, without a per-component selection list. JS imports alone do not select native sources. |
+| Component scope | Welcomes both system UI and third-party UI, such as [GlassText](#liquidglasstext). Adding components to the catalog does not require apps to include their UI implementations when they remain unselected. | Centers on SwiftUI and Jetpack Compose. Supports [custom SwiftUI components and modifiers, including third-party SwiftUI libraries](https://docs.expo.dev/guides/expo-ui-swift-ui/extending/). |
+| React API | Familiar props, children, and controlled/uncontrolled state, composed with ordinary React Native views. Names and behavior stay close to the underlying native APIs. | Exposes native toolkit concepts through React, including SwiftUI views, modifiers, and a [`Host` container](https://docs.expo.dev/versions/latest/sdk/ui/swift-ui/#usage). |
+| Supported targets and maintenance | iOS 17+ and the New Architecture only. Excluding older iOS versions and the legacy bridge reduces compatibility code and keeps maintenance focused. | Covers a broader platform scope: SwiftUI on iOS, Jetpack Compose on Android, and [universal components for iOS, Android, and web](https://docs.expo.dev/versions/latest/sdk/ui/universal/). Requirements depend on the Expo SDK and component. |
+
+For the smallest builds, combine component-specific JS imports with
+[`react-native-tinyui.components`](#optional-component-selection). All native
+components are enabled by default, so configure that list explicitly. Shared
+core code, Fabric Codegen, and lightweight registration stubs remain in the
+native build; the size savings come from excluding unused UI implementations.
+Final bundle size also depends on the app's bundler and linker settings.
 
 ## Requirements
 
@@ -74,6 +105,8 @@ compatibility. JavaScript entry points provide cleaner dependency boundaries;
 
 ## Menu
 
+<img src="docs/screenshots/menu.png" alt="Menu with native document actions expanded" width="320" />
+
 `Menu` uses `children` as its trigger and receives its native menu entries
 through the `options` prop. A tap opens the native menu; `onActionPress`
 receives every selected action's stable id and displayed title.
@@ -132,6 +165,36 @@ or `type: 'divider'` for structural entries; nested entries use their own
 `options` array. SF Symbols are passed with `systemImage`; missing symbols
 simply render no image.
 
+The trigger can be nested inside a React Native `Pressable` or `Touchable`.
+Tapping an enabled menu trigger opens the menu without firing the parent's
+touch or press handlers; tapping elsewhere in the parent keeps its normal behavior.
+
+To open the menu from another control, call `open()` on its ref:
+
+```tsx
+import { useRef } from 'react';
+import { Button, Text } from 'react-native';
+import { Menu, type MenuRef } from 'react-native-tinyui/menu';
+
+function DocumentMenu() {
+  const menuRef = useRef<MenuRef>(null);
+
+  return (
+    <>
+      <Menu ref={menuRef} options={[{ id: 'rename', title: 'Rename' }]}>
+        <Text>Document actions</Text>
+      </Menu>
+      <Button title="Open menu" onPress={() => menuRef.current?.open()} />
+    </>
+  );
+}
+```
+
+`open()` requires iOS 17.4 or newer and anchors the menu to its mounted trigger.
+It does nothing on older iOS versions, while `disabled`, or when the trigger is
+detached. Tapping the trigger still works on all supported iOS versions. The ref
+also retains the outer View's methods, such as `measure` and `measureInWindow`.
+
 Action options support `subtitle`, `state`, `destructive`, `disabled`, `hidden`,
 and `keepOpen`. Set explicit `id` values when handling `onActionPress`; actions
 without one receive a generated menu-path id. Use `icon` to load an image from
@@ -144,6 +207,8 @@ plus `destructive`, `disabled`, `hidden`, and `displayInline`.
 
 ## Popover
 
+<img src="docs/screenshots/popover.png" alt="Popover displaying resizable content above its trigger" width="320" />
+
 `Popover` supports standard controlled and uncontrolled React state. Its content
 remains a normal interactive React Native view tree hosted by a real
 `UIPopoverPresentationController`.
@@ -189,6 +254,8 @@ outer container, not the presented content.
 
 ## TipKit
 
+<img src="docs/screenshots/tip-kit.png" alt="TipKit popover with a save action anchored to the favorite button" width="320" />
+
 `TipKit.Popover` anchors a native TipKit `TipUIPopoverViewController` to ordinary
 React Native children on iOS 17+. The children retain their own touch handlers;
 the tip appears automatically when both `enabled` and TipKit's eligibility allow
@@ -288,6 +355,8 @@ ID for trying the behavior again without clearing the app's TipKit datastore.
 
 ## LiquidGlassText
 
+<img src="docs/screenshots/liquid-glass-text.png" alt="LiquidGlassText rendering English, Chinese, and numbers over a photo" width="320" />
+
 `LiquidGlassText` renders native glass inside the glyph outlines, based on
 [GlassText](https://github.com/ailtonvivaz/GlassText). It exposes the effect and
 typography through React props.
@@ -354,6 +423,8 @@ The adapted Core Text outline implementation retains the upstream MIT notice in
 
 ## Stepper
 
+<img src="docs/screenshots/stepper.png" alt="Native Stepper with a controlled value and configurable range" width="320" />
+
 `Stepper` bridges UIKit's
 [`UIStepper`](https://developer.apple.com/documentation/uikit/uistepper) through
 Fabric. It supports fractional steps, press-and-hold repeat, and wrapping at
@@ -412,6 +483,8 @@ stepper shows the minus and plus buttons; render a separate `Text` for the value
 
 ## ConcentricView
 
+<img src="docs/screenshots/concentric-view.png" alt="Nested ConcentricView containers following the bottom screen corners" width="320" />
+
 `ConcentricView` is a Fabric container that lets UIKit resolve its corner radii
 relative to its containing view. On iOS 26+, it applies
 [`UICornerRadius.containerConcentricRadius`](https://developer.apple.com/documentation/uikit/uicornerradius-c.class/containerconcentricradius)
@@ -447,6 +520,8 @@ concentric radii; keep those decorations on a surrounding view when needed.
 
 ## SFSymbol
 
+<img src="docs/screenshots/sf-symbol.png" alt="SFSymbol rendering a bell badge with native symbol colors" width="320" />
+
 `SFSymbol` uses **UIKit `UIImageView` + Apple's Symbols framework**, exposed
 through Fabric. It does not embed a SwiftUI hosting view. Xcode 26+ is required
 to build; the deployment target remains iOS 17. Yoga measures the configured
@@ -559,6 +634,46 @@ multicolor and variable/draw support depend on each symbol's native annotations.
 transitions are suppressed while Reduce Motion is enabled, while scale and
 visibility state changes apply instantly. Set it to `false` to opt out.
 
+## Example App
+
+The [example app](example/src/App.tsx) demonstrates Menu, Popover, TipKit,
+LiquidGlassText, Stepper, ConcentricView, and SFSymbol. It includes all native
+components, so building it requires Xcode 26+. Use iOS 26+ to try the glass effects
+and the latest SF Symbol features.
+
+From the repository root, install the dependencies:
+
+```sh
+yarn
+```
+
+Install the example's Pods:
+
+```sh
+cd example/ios && pod install
+```
+
+Then run Metro and the iOS app from the repository root in separate terminals:
+
+```sh
+yarn example start
+```
+
+```sh
+yarn example ios
+```
+
+The example uses Metro port `8082`, which is already configured in these scripts.
+See the [development workflow](CONTRIBUTING.md#development-workflow) for more
+details.
+
+## Apps Using This Library
+
+- [Night Vision - LiDAR Camera](https://apps.apple.com/app/id1668629667)
+- [Laser Measure - LiDAR Powered](https://apps.apple.com/app/id6466744678)
+- [PhoneAway - Digital Detox](https://apps.apple.com/app/id6744548607)
+- [Fatigue Alert - Stay Awake](https://apps.apple.com/app/id6479893638)
+
 ## Contributing
 
 - [Development workflow](CONTRIBUTING.md#development-workflow)

package/ios/Menu/TinyuiMenuProvider.swift

@@ -1,4 +1,5 @@
 import UIKit
+import UIKit.UIGestureRecognizerSubclass
 
 /**
  * UIButton-backed UIKit menu trigger used as the Fabric component's content
@@ -6,6 +7,7 @@ import UIKit
  */
 @objc public final class TinyuiMenuProvider: UIButton {
   private weak var delegate: TinyuiMenuViewDelegate?
+  private weak var menuTouchGate: TinyuiMenuTouchGate?
 
   @objc public var triggerView: UIView? {
     didSet {
@@ -35,6 +37,32 @@ import UIKit
     configure()
   }
 
+  override public func didMoveToWindow() {
+    super.didMoveToWindow()
+    menuTouchGate?.presentedMenus.remove(self)
+    menuTouchGate = window.map { TinyuiMenuTouchGate.install(in: $0) }
+  }
+
+  override public func contextMenuInteraction(
+    _ interaction: UIContextMenuInteraction,
+    willDisplayMenuFor configuration: UIContextMenuConfiguration,
+    animator: UIContextMenuInteractionAnimating?
+  ) {
+    super.contextMenuInteraction(interaction, willDisplayMenuFor: configuration, animator: animator)
+    menuTouchGate?.presentedMenus.add(self)
+  }
+
+  override public func contextMenuInteraction(
+    _ interaction: UIContextMenuInteraction,
+    willEndFor configuration: UIContextMenuConfiguration,
+    animator: UIContextMenuInteractionAnimating?
+  ) {
+    super.contextMenuInteraction(interaction, willEndFor: configuration, animator: animator)
+    // The dismissal touch has already been filtered. New touches during the
+    // closing animation belong to the page again.
+    menuTouchGate?.presentedMenus.remove(self)
+  }
+
   override public func layoutSubviews() {
     super.layoutSubviews()
     triggerView?.frame = bounds
@@ -56,6 +84,16 @@ import UIKit
     showsMenuAsPrimaryAction = true
   }
 
+  @objc public func openMenu() {
+    guard isEnabled, isUserInteractionEnabled, !isHidden, alpha > 0.01,
+          window != nil, !bounds.isEmpty, menu != nil else {
+      return
+    }
+    if #available(iOS 17.4, *) {
+      performPrimaryAction()
+    }
+  }
+
   /** Applies one complete Fabric props snapshot before rebuilding the menu. */
   @objc public func update(
     menuConfig: [String: Any],
@@ -80,3 +118,65 @@ import UIKit
     )
   }
 }
+
+/**
+ * Uses the early-event filtering approach from Expo's SystemMenuTouchGate:
+ * https://github.com/expo/expo/pull/49775
+ * TinyUI tracks its own menus through public UIButton lifecycle callbacks.
+ */
+final class TinyuiMenuTouchGate: UIGestureRecognizer, UIGestureRecognizerDelegate {
+  let presentedMenus = NSHashTable<TinyuiMenuProvider>.weakObjects()
+  private static let surfaceTouchHandlerClass = NSClassFromString("RCTSurfaceTouchHandler")
+
+  init() {
+    super.init(target: nil, action: nil)
+    cancelsTouchesInView = false
+    delaysTouchesBegan = false
+    delaysTouchesEnded = false
+    delegate = self
+  }
+
+  static func install(in window: UIWindow) -> TinyuiMenuTouchGate {
+    if let gate = window.gestureRecognizers?.first(where: { $0 is TinyuiMenuTouchGate })
+      as? TinyuiMenuTouchGate {
+      return gate
+    }
+    let gate = TinyuiMenuTouchGate()
+    window.addGestureRecognizer(gate)
+    return gate
+  }
+
+  private func ignoreReactTouches(_ touches: Set<UITouch>, event: UIEvent) {
+    guard let window = view as? UIWindow,
+          presentedMenus.allObjects.contains(where: { $0.window === window }),
+          let handlerClass = Self.surfaceTouchHandlerClass else {
+      return
+    }
+
+    for touch in touches where touch.phase == .began {
+      var ancestor = touch.view
+      while let current = ancestor {
+        for handler in current.gestureRecognizers ?? [] where handler.isKind(of: handlerClass) {
+          handler.ignore(touch, for: event)
+        }
+        ancestor = current.superview
+      }
+    }
+  }
+
+  func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldReceive event: UIEvent) -> Bool {
+    // Filtering in touchesBegan alone is too late: RN may already have sent
+    // touchStart/onPressIn to JS. UIKit asks this delegate before delivery.
+    if let touches = event.allTouches {
+      ignoreReactTouches(touches, event: event)
+    }
+    return true
+  }
+
+  override func touchesBegan(_ touches: Set<UITouch>, with event: UIEvent) {
+    super.touchesBegan(touches, with: event)
+    // Fallback for delivery orders where RN sees the touch first.
+    ignoreReactTouches(touches, event: event)
+    state = .failed
+  }
+}

package/ios/Menu/TinyuiMenuView.mm

@@ -64,6 +64,33 @@ using namespace facebook::react;
   }
 }
 
+#pragma mark - Touch handling
+
+- (SharedTouchEventEmitter)touchEventEmitterAtPoint:(CGPoint)point
+{
+  // The provider's hitTest returns its UIButton, so the surface touch handler
+  // finds this Fabric view first. Keep the trigger's touch sequence in UIKit:
+  // forwarding it to JS lets an ancestor Pressable/Touchable claim the same
+  // touch and run its press callbacks while the native menu is opening.
+  if (_menuProvider.isEnabled) {
+    return nullptr;
+  }
+
+  return [super touchEventEmitterAtPoint:point];
+}
+
+#pragma mark - Commands
+
+- (void)handleCommand:(const NSString *)commandName args:(const NSArray *)args
+{
+  RCTTinyuiMenuViewHandleCommand(self, commandName, args);
+}
+
+- (void)open
+{
+  [_menuProvider openMenu];
+}
+
 #pragma mark - Props
 
 - (void)updateProps:(Props::Shared const &)props

package/lib/module/Menu/MenuNativeComponent.ts

@@ -1,6 +1,9 @@
+import type * as React from 'react';
 import {
   codegenNativeComponent,
+  codegenNativeCommands,
   type CodegenTypes,
+  type HostComponent,
   type ViewProps,
 } from 'react-native';
 import type { DirectEventHandler } from 'react-native/Libraries/Types/CodegenTypes';
@@ -12,6 +15,14 @@ export interface NativeMenuProps extends ViewProps {
   onActionPress?: DirectEventHandler<Readonly<{ id: string; title: string }>>;
 }
 
+interface NativeCommands {
+  open: (viewRef: React.ComponentRef<HostComponent<NativeMenuProps>>) => void;
+}
+
+export const Commands = codegenNativeCommands<NativeCommands>({
+  supportedCommands: ['open'],
+});
+
 export default codegenNativeComponent<NativeMenuProps>('TinyuiMenuView', {
   excludedPlatforms: ['android'],
 });

package/lib/module/Menu/index.js

@@ -1,9 +1,9 @@
 "use strict";
 
-import { forwardRef } from 'react';
+import { forwardRef, useImperativeHandle, useRef } from 'react';
 import { View } from 'react-native';
 import { assertComponentEnabled } from "../utils/index.js";
-import NativeMenuView from './MenuNativeComponent';
+import NativeMenuView, { Commands } from './MenuNativeComponent';
 import { serializeMenuOptions } from "./options.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 const MenuRoot = /*#__PURE__*/forwardRef(function Menu({
@@ -17,12 +17,22 @@ const MenuRoot = /*#__PURE__*/forwardRef(function Menu({
   ...viewProps
 }, ref) {
   assertComponentEnabled('Menu');
+  const viewRef = useRef(null);
+  const nativeRef = useRef(null);
+  useImperativeHandle(ref, () => Object.assign(viewRef.current, {
+    open() {
+      if (!disabled && nativeRef.current) {
+        Commands.open(nativeRef.current);
+      }
+    }
+  }), [disabled]);
   const menuConfig = serializeMenuOptions(options);
   return /*#__PURE__*/_jsx(View, {
     ...viewProps,
-    ref: ref,
+    ref: viewRef,
     collapsable: false,
     children: /*#__PURE__*/_jsx(NativeMenuView, {
+      ref: nativeRef,
       accessibilityLabel: accessibilityLabel,
       disabled: disabled,
       menuConfig: menuConfig,

package/lib/module/Menu/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["forwardRef","View","assertComponentEnabled","NativeMenuView","serializeMenuOptions","jsx","_jsx","MenuRoot","Menu","accessibilityLabel","children","disabled","onActionPress","options","title","testID","viewProps","ref","menuConfig","collapsable"],"sourceRoot":"../../../src","sources":["Menu/index.tsx"],"mappings":";;AAAA,SAASA,UAAU,QAA2B,OAAO;AACrD,SAASC,IAAI,QAAQ,cAAc;AAEnC,SAASC,sBAAsB,QAAQ,mBAAU;AAEjD,OAAOC,cAAc,MAAM,uBAAuB;AAClD,SAASC,oBAAoB,QAAQ,cAAW;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAEjD,MAAMC,QAAQ,gBAAGP,UAAU,CAAuC,SAASQ,IAAIA,CAC7E;EACEC,kBAAkB;EAClBC,QAAQ;EACRC,QAAQ;EACRC,aAAa;EACbC,OAAO;EACPC,KAAK;EACLC,MAAM;EACN,GAAGC;AACL,CAAC,EACDC,GAAG,EACH;EACAf,sBAAsB,CAAC,MAAM,CAAC;EAE9B,MAAMgB,UAAU,GAAGd,oBAAoB,CAACS,OAAO,CAAC;EAEhD,oBACEP,IAAA,CAACL,IAAI;IAAA,GAAKe,SAAS;IAAEC,GAAG,EAAEA,GAAI;IAACE,WAAW,EAAE,KAAM;IAAAT,QAAA,eAChDJ,IAAA,CAACH,cAAc;MACbM,kBAAkB,EAAEA,kBAAmB;MACvCE,QAAQ,EAAEA,QAAS;MACnBO,UAAU,EAAEA,UAAW;MACvBN,aAAa,EAAEA,aAAc;MAC7BG,MAAM,EAAEA,MAAO;MACfD,KAAK,EAAEA,KAAM;MAAAJ,QAAA,eAEbJ,IAAA,CAACL,IAAI;QAACkB,WAAW,EAAE,KAAM;QAAAT,QAAA,EAAEA;MAAQ,CAAO;IAAC,CAC7B;EAAC,CACb,CAAC;AAEX,CAAC,CAAC;AAEF,OAAO,MAAMF,IAAI,GAAGD,QAAyB","ignoreList":[]}
+{"version":3,"names":["forwardRef","useImperativeHandle","useRef","View","assertComponentEnabled","NativeMenuView","Commands","serializeMenuOptions","jsx","_jsx","MenuRoot","Menu","accessibilityLabel","children","disabled","onActionPress","options","title","testID","viewProps","ref","viewRef","nativeRef","Object","assign","current","open","menuConfig","collapsable"],"sourceRoot":"../../../src","sources":["Menu/index.tsx"],"mappings":";;AAAA,SACEA,UAAU,EACVC,mBAAmB,EACnBC,MAAM,QAED,OAAO;AACd,SAASC,IAAI,QAA2B,cAAc;AAEtD,SAASC,sBAAsB,QAAQ,mBAAU;AAEjD,OAAOC,cAAc,IAAIC,QAAQ,QAAQ,uBAAuB;AAChE,SAASC,oBAAoB,QAAQ,cAAW;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAEjD,MAAMC,QAAQ,gBAAGV,UAAU,CAAqB,SAASW,IAAIA,CAC3D;EACEC,kBAAkB;EAClBC,QAAQ;EACRC,QAAQ;EACRC,aAAa;EACbC,OAAO;EACPC,KAAK;EACLC,MAAM;EACN,GAAGC;AACL,CAAC,EACDC,GAAG,EACH;EACAhB,sBAAsB,CAAC,MAAM,CAAC;EAE9B,MAAMiB,OAAO,GAAGnB,MAAM,CAAe,IAAI,CAAC;EAC1C,MAAMoB,SAAS,GAAGpB,MAAM,CAAsC,IAAI,CAAC;EAEnED,mBAAmB,CACjBmB,GAAG,EACH,MACEG,MAAM,CAACC,MAAM,CAACH,OAAO,CAACI,OAAO,EAAG;IAC9BC,IAAIA,CAAA,EAAG;MACL,IAAI,CAACZ,QAAQ,IAAIQ,SAAS,CAACG,OAAO,EAAE;QAClCnB,QAAQ,CAACoB,IAAI,CAACJ,SAAS,CAACG,OAAO,CAAC;MAClC;IACF;EACF,CAAC,CAAC,EACJ,CAACX,QAAQ,CACX,CAAC;EAED,MAAMa,UAAU,GAAGpB,oBAAoB,CAACS,OAAO,CAAC;EAEhD,oBACEP,IAAA,CAACN,IAAI;IAAA,GAAKgB,SAAS;IAAEC,GAAG,EAAEC,OAAQ;IAACO,WAAW,EAAE,KAAM;IAAAf,QAAA,eACpDJ,IAAA,CAACJ,cAAc;MACbe,GAAG,EAAEE,SAAU;MACfV,kBAAkB,EAAEA,kBAAmB;MACvCE,QAAQ,EAAEA,QAAS;MACnBa,UAAU,EAAEA,UAAW;MACvBZ,aAAa,EAAEA,aAAc;MAC7BG,MAAM,EAAEA,MAAO;MACfD,KAAK,EAAEA,KAAM;MAAAJ,QAAA,eAEbJ,IAAA,CAACN,IAAI;QAACyB,WAAW,EAAE,KAAM;QAAAf,QAAA,EAAEA;MAAQ,CAAO;IAAC,CAC7B;EAAC,CACb,CAAC;AAEX,CAAC,CAAC;AAEF,OAAO,MAAMF,IAAI,GAAGD,QAAyB","ignoreList":[]}

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["Menu","TipKit","Stepper","ConcentricView","SFSymbol","Popover","PopoverClose","getNativeTinyui","assertComponentEnabled","LiquidGlassText"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,IAAI,QAAQ,iBAAQ;AAC7B,SAASC,MAAM,QAAQ,mBAAU;AAsBjC,SAASC,OAAO,QAAQ,oBAAW;AAGnC,SAASC,cAAc,QAAQ,2BAAkB;AAGjD,SAASC,QAAQ,QAAQ,qBAAY;AAYrC,SAASC,OAAO,EAAEC,YAAY,QAAQ,oBAAW;AAUjD,SAASC,eAAe,EAAEC,sBAAsB,QAAQ,kBAAS;AAGjE,SAASC,eAAe,QAAQ,4BAAmB","ignoreList":[]}
+{"version":3,"names":["Menu","TipKit","Stepper","ConcentricView","SFSymbol","Popover","PopoverClose","getNativeTinyui","assertComponentEnabled","LiquidGlassText"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,IAAI,QAAQ,iBAAQ;AAC7B,SAASC,MAAM,QAAQ,mBAAU;AAuBjC,SAASC,OAAO,QAAQ,oBAAW;AAGnC,SAASC,cAAc,QAAQ,2BAAkB;AAGjD,SAASC,QAAQ,QAAQ,qBAAY;AAYrC,SAASC,OAAO,EAAEC,YAAY,QAAQ,oBAAW;AAUjD,SAASC,eAAe,EAAEC,sBAAsB,QAAQ,kBAAS;AAGjE,SAASC,eAAe,QAAQ,4BAAmB","ignoreList":[]}

package/lib/typescript/src/Menu/MenuNativeComponent.d.ts

@@ -1,4 +1,5 @@
-import { type CodegenTypes, type ViewProps } from 'react-native';
+import type * as React from 'react';
+import { type CodegenTypes, type HostComponent, type ViewProps } from 'react-native';
 import type { DirectEventHandler } from 'react-native/Libraries/Types/CodegenTypes';
 export interface NativeMenuProps extends ViewProps {
     menuConfig: CodegenTypes.UnsafeMixed;
@@ -9,6 +10,10 @@ export interface NativeMenuProps extends ViewProps {
         title: string;
     }>>;
 }
+interface NativeCommands {
+    open: (viewRef: React.ComponentRef<HostComponent<NativeMenuProps>>) => void;
+}
+export declare const Commands: NativeCommands;
 declare const _default: import("react-native/types_generated/Libraries/Utilities/codegenNativeComponent").NativeComponentType<NativeMenuProps>;
 export default _default;
 //# sourceMappingURL=MenuNativeComponent.d.ts.map

package/lib/typescript/src/Menu/MenuNativeComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MenuNativeComponent.d.ts","sourceRoot":"","sources":["../../../../src/Menu/MenuNativeComponent.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAEpF,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,UAAU,EAAE,YAAY,CAAC,WAAW,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,kBAAkB,CAAC,QAAQ,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;CAC7E;;AAED,wBAEG"}
+{"version":3,"file":"MenuNativeComponent.d.ts","sourceRoot":"","sources":["../../../../src/Menu/MenuNativeComponent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAEpF,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,UAAU,EAAE,YAAY,CAAC,WAAW,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,kBAAkB,CAAC,QAAQ,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;CAC7E;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC,KAAK,IAAI,CAAC;CAC7E;AAED,eAAO,MAAM,QAAQ,gBAEnB,CAAC;;AAEH,wBAEG"}

package/lib/typescript/src/Menu/index.d.ts

@@ -1,4 +1,4 @@
 import type { MenuComponent } from './types.js';
 export declare const Menu: MenuComponent;
-export type { MenuActionOption, MenuActionPressEvent, MenuActionPressEventData, MenuDividerOption, MenuItemState, MenuOption, MenuProps, MenuSectionOption, MenuSubmenuOption, } from './types.js';
+export type { MenuActionOption, MenuActionPressEvent, MenuActionPressEventData, MenuDividerOption, MenuItemState, MenuOption, MenuProps, MenuRef, MenuSectionOption, MenuSubmenuOption, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/Menu/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/Menu/index.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,YAAS,CAAC;AAqCxD,eAAO,MAAM,IAAI,EAAe,aAAa,CAAC;AAE9C,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,YAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/Menu/index.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,YAAS,CAAC;AAsDjE,eAAO,MAAM,IAAI,EAAe,aAAa,CAAC;AAE9C,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,SAAS,EACT,OAAO,EACP,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,YAAS,CAAC"}

package/lib/typescript/src/Menu/types.d.ts

@@ -1,5 +1,5 @@
-import type { ComponentRef, ForwardRefExoticComponent, ReactNode, RefAttributes } from 'react';
-import type { ColorValue, View, ViewProps } from 'react-native';
+import type { ForwardRefExoticComponent, ReactNode, RefAttributes } from 'react';
+import type { ColorValue, HostInstance, ViewProps } from 'react-native';
 export type MenuItemState = 'off' | 'on' | 'mixed';
 interface MenuOptionLabel {
     title: string;
@@ -59,6 +59,13 @@ export interface MenuActionPressEventData {
 export type MenuActionPressEvent = Readonly<{
     nativeEvent: Readonly<MenuActionPressEventData>;
 }>;
+export type MenuRef = HostInstance & {
+    /**
+     * Opens the menu at its mounted trigger on iOS 17.4 and newer.
+     * Does nothing on older iOS versions or while disabled or detached.
+     */
+    open(): void;
+};
 export interface MenuProps extends Omit<ViewProps, 'children'> {
     /** The trigger element. */
     children: ReactNode;
@@ -71,7 +78,7 @@ export interface MenuProps extends Omit<ViewProps, 'children'> {
     /** Called whenever an enabled action is selected. */
     onActionPress?: (event: MenuActionPressEvent) => void;
 }
-export interface MenuComponent extends ForwardRefExoticComponent<MenuProps & RefAttributes<ComponentRef<typeof View>>> {
+export interface MenuComponent extends ForwardRefExoticComponent<MenuProps & RefAttributes<MenuRef>> {
 }
 export {};
 //# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/Menu/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/Menu/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,yBAAyB,EACzB,SAAS,EACT,aAAa,EACd,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEhE,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,IAAI,GAAG,OAAO,CAAC;AAEnD,UAAU,eAAe;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+FAA+F;IAC/F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB;;;;OAIG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,mEAAmE;IACnE,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,gEAAgE;IAChE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,IAAI,EAAE,SAAS,CAAC;IAChB,yDAAyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kDAAkD;IAClD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qEAAqE;IACrE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,MAAM,UAAU,GACpB,gBAAgB,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAE/E,MAAM,WAAW,wBAAwB;IACvC,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,WAAW,EAAE,QAAQ,CAAC,wBAAwB,CAAC,CAAC;CACjD,CAAC,CAAC;AAEH,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IAC5D,2BAA2B;IAC3B,QAAQ,EAAE,SAAS,CAAC;IACpB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IAC/B,kDAAkD;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qDAAqD;IACrD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,aAAc,SAAQ,yBAAyB,CAC9D,SAAS,GAAG,aAAa,CAAC,YAAY,CAAC,OAAO,IAAI,CAAC,CAAC,CACrD;CAAG"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/Menu/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,SAAS,EACT,aAAa,EACd,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAExE,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,IAAI,GAAG,OAAO,CAAC;AAEnD,UAAU,eAAe;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+FAA+F;IAC/F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB;;;;OAIG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,mEAAmE;IACnE,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,gEAAgE;IAChE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,IAAI,EAAE,SAAS,CAAC;IAChB,yDAAyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kDAAkD;IAClD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qEAAqE;IACrE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,MAAM,UAAU,GACpB,gBAAgB,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAE/E,MAAM,WAAW,wBAAwB;IACvC,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,WAAW,EAAE,QAAQ,CAAC,wBAAwB,CAAC,CAAC;CACjD,CAAC,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,YAAY,GAAG;IACnC;;;OAGG;IACH,IAAI,IAAI,IAAI,CAAC;CACd,CAAC;AAEF,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IAC5D,2BAA2B;IAC3B,QAAQ,EAAE,SAAS,CAAC;IACpB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IAC/B,kDAAkD;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qDAAqD;IACrD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,aAAc,SAAQ,yBAAyB,CAC9D,SAAS,GAAG,aAAa,CAAC,OAAO,CAAC,CACnC;CAAG"}

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

@@ -1,7 +1,7 @@
 export { Menu } from './Menu/index.js';
 export { TipKit } from './TipKit/index.js';
 export type { TipAction, TipDisplayFrequency, TipError, TipInvalidationReason, TipPopoverProps, TipKitConfiguration, TipStatus, } from './TipKit/index.js';
-export type { MenuActionOption, MenuActionPressEvent, MenuActionPressEventData, MenuDividerOption, MenuItemState, MenuOption, MenuProps, MenuSectionOption, MenuSubmenuOption, } from './Menu/index.js';
+export type { MenuActionOption, MenuActionPressEvent, MenuActionPressEventData, MenuDividerOption, MenuItemState, MenuOption, MenuProps, MenuRef, MenuSectionOption, MenuSubmenuOption, } from './Menu/index.js';
 export { Stepper } from './Stepper/index.js';
 export type { StepperProps } from './Stepper/index.js';
 export { ConcentricView } from './ConcentricView/index.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAQ,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAU,CAAC;AAClC,YAAY,EACV,SAAS,EACT,mBAAmB,EACnB,QAAQ,EACR,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,SAAS,GACV,MAAM,mBAAU,CAAC;AAClB,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,iBAAQ,CAAC;AAEhB,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAW,CAAC;AACpC,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAW,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,2BAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAAkB,CAAC;AAE5D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAY,CAAC;AACtC,YAAY,EACV,yBAAyB,EACzB,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,cAAc,GACf,MAAM,qBAAY,CAAC;AAEpB,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAW,CAAC;AAClD,YAAY,EACV,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,EACd,wBAAwB,EACxB,YAAY,GACb,MAAM,oBAAW,CAAC;AAEnB,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,kBAAS,CAAC;AAClE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAS,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAAmB,CAAC;AACpD,YAAY,EACV,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,4BAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAQ,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAU,CAAC;AAClC,YAAY,EACV,SAAS,EACT,mBAAmB,EACnB,QAAQ,EACR,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,SAAS,GACV,MAAM,mBAAU,CAAC;AAClB,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,SAAS,EACT,OAAO,EACP,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,iBAAQ,CAAC;AAEhB,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAW,CAAC;AACpC,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAW,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,2BAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAAkB,CAAC;AAE5D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAY,CAAC;AACtC,YAAY,EACV,yBAAyB,EACzB,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,cAAc,GACf,MAAM,qBAAY,CAAC;AAEpB,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAW,CAAC;AAClD,YAAY,EACV,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,EACd,wBAAwB,EACxB,YAAY,GACb,MAAM,oBAAW,CAAC;AAEnB,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,kBAAS,CAAC;AAClE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAS,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAAmB,CAAC;AACpD,YAAY,EACV,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,4BAAmB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-tinyui",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "Dependency-free native iOS Menu, Popover, TipKit, Stepper, ConcentricView, SFSymbol and LiquidGlassText components for React Native",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/Menu/MenuNativeComponent.ts

@@ -1,6 +1,9 @@
+import type * as React from 'react';
 import {
   codegenNativeComponent,
+  codegenNativeCommands,
   type CodegenTypes,
+  type HostComponent,
   type ViewProps,
 } from 'react-native';
 import type { DirectEventHandler } from 'react-native/Libraries/Types/CodegenTypes';
@@ -12,6 +15,14 @@ export interface NativeMenuProps extends ViewProps {
   onActionPress?: DirectEventHandler<Readonly<{ id: string; title: string }>>;
 }
 
+interface NativeCommands {
+  open: (viewRef: React.ComponentRef<HostComponent<NativeMenuProps>>) => void;
+}
+
+export const Commands = codegenNativeCommands<NativeCommands>({
+  supportedCommands: ['open'],
+});
+
 export default codegenNativeComponent<NativeMenuProps>('TinyuiMenuView', {
   excludedPlatforms: ['android'],
 });

package/src/Menu/index.tsx

@@ -1,12 +1,17 @@
-import { forwardRef, type ComponentRef } from 'react';
-import { View } from 'react-native';
+import {
+  forwardRef,
+  useImperativeHandle,
+  useRef,
+  type ComponentRef,
+} from 'react';
+import { View, type HostInstance } from 'react-native';
 
 import { assertComponentEnabled } from '../utils';
-import type { MenuComponent, MenuProps } from './types';
-import NativeMenuView from './MenuNativeComponent';
+import type { MenuComponent, MenuProps, MenuRef } from './types';
+import NativeMenuView, { Commands } from './MenuNativeComponent';
 import { serializeMenuOptions } from './options';
 
-const MenuRoot = forwardRef<ComponentRef<typeof View>, MenuProps>(function Menu(
+const MenuRoot = forwardRef<MenuRef, MenuProps>(function Menu(
   {
     accessibilityLabel,
     children,
@@ -21,11 +26,28 @@ const MenuRoot = forwardRef<ComponentRef<typeof View>, MenuProps>(function Menu(
 ) {
   assertComponentEnabled('Menu');
 
+  const viewRef = useRef<HostInstance>(null);
+  const nativeRef = useRef<ComponentRef<typeof NativeMenuView>>(null);
+
+  useImperativeHandle(
+    ref,
+    () =>
+      Object.assign(viewRef.current!, {
+        open() {
+          if (!disabled && nativeRef.current) {
+            Commands.open(nativeRef.current);
+          }
+        },
+      }),
+    [disabled]
+  );
+
   const menuConfig = serializeMenuOptions(options);
 
   return (
-    <View {...viewProps} ref={ref} collapsable={false}>
+    <View {...viewProps} ref={viewRef} collapsable={false}>
       <NativeMenuView
+        ref={nativeRef}
         accessibilityLabel={accessibilityLabel}
         disabled={disabled}
         menuConfig={menuConfig}
@@ -49,6 +71,7 @@ export type {
   MenuItemState,
   MenuOption,
   MenuProps,
+  MenuRef,
   MenuSectionOption,
   MenuSubmenuOption,
 } from './types';

package/src/Menu/types.ts

@@ -1,10 +1,9 @@
 import type {
-  ComponentRef,
   ForwardRefExoticComponent,
   ReactNode,
   RefAttributes,
 } from 'react';
-import type { ColorValue, View, ViewProps } from 'react-native';
+import type { ColorValue, HostInstance, ViewProps } from 'react-native';
 
 export type MenuItemState = 'off' | 'on' | 'mixed';
 
@@ -75,6 +74,14 @@ export type MenuActionPressEvent = Readonly<{
   nativeEvent: Readonly<MenuActionPressEventData>;
 }>;
 
+export type MenuRef = HostInstance & {
+  /**
+   * Opens the menu at its mounted trigger on iOS 17.4 and newer.
+   * Does nothing on older iOS versions or while disabled or detached.
+   */
+  open(): void;
+};
+
 export interface MenuProps extends Omit<ViewProps, 'children'> {
   /** The trigger element. */
   children: ReactNode;
@@ -89,5 +96,5 @@ export interface MenuProps extends Omit<ViewProps, 'children'> {
 }
 
 export interface MenuComponent extends ForwardRefExoticComponent<
-  MenuProps & RefAttributes<ComponentRef<typeof View>>
+  MenuProps & RefAttributes<MenuRef>
 > {}

package/src/index.tsx

@@ -17,6 +17,7 @@ export type {
   MenuItemState,
   MenuOption,
   MenuProps,
+  MenuRef,
   MenuSectionOption,
   MenuSubmenuOption,
 } from './Menu';