@vellira-ui/react-native 2.25.1 → 2.26.1

package/README.md

@@ -111,6 +111,27 @@ export function RoleSelect() {
 }
 ```
 
+### Dropdown Notes
+
+Use `Dropdown` for contextual actions, not saved form values. The `items` model
+is flat: use `{ type: 'group', label }` as a heading before related actions and
+`{ type: 'separator' }` between sections. Use `open`, `defaultOpen`, and
+`onOpenChange` for menu state, and `onSelect` for the selected action value.
+
+```tsx
+import type { DropdownItem } from '@vellira-ui/react-native';
+import { Dropdown } from '@vellira-ui/react-native';
+
+const items: DropdownItem[] = [
+  { type: 'group', label: 'File' },
+  { label: 'Duplicate', value: 'duplicate' },
+  { type: 'separator' },
+  { label: 'Delete', value: 'delete', danger: true },
+];
+
+<Dropdown label='Actions' items={items} onSelect={handleAction} />;
+```
+
 ### FormField Notes
 
 `FormField` is a presentational wrapper for custom native controls. Do not wrap

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export type { DropdownProps } from './components/Dropdown';
 export { Dropdown } from './components/Dropdown';
+export type { DropdownGroup as DropdownGroupItem, DropdownItem, DropdownMenuItem, DropdownProps, DropdownSeparator as DropdownSeparatorItem, } from './components/Dropdown/types';
 export type { ModalProps } from './components/Modal';
 export { Modal } from './components/Modal';
 export type { RadioGroupProps } from './components/RadioGroup';