{"_id":"@aargon-ui/radio","name":"@aargon-ui/radio","dist-tags":{"latest":"1.0.0-beta.1"},"versions":{"1.0.0-beta.1":{"name":"@aargon-ui/radio","version":"1.0.0-beta.1","description":"Animated radio component for React Native","main":"lib/index.js","types":"lib/index.d.ts","scripts":{"build":"tsc","build:watch":"tsc --watch","dev":"tsc --watch","type-check":"tsc --noEmit","lint":"eslint src --ext .ts,.tsx","clean":"rm -rf lib","release":"npm publish --otp=$OTP --access public"},"keywords":["react-native","radio","animated","ui","component"],"author":{"name":"Md Muhaiminul"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/aargon007/aargon-ui.git","directory":"packages/radio"},"homepage":"https://github.com/aargon007/aargon-ui/packages/radio#readme","bugs":{"url":"https://github.com/aargon007/aargon-ui/issues"},"peerDependencies":{"react":">=19.0.0","react-native":">=0.81.0","react-native-reanimated":">=3.0.0"},"devDependencies":{"@types/react":"~19.1.10","@types/react-native":"^0.72.8","typescript":"~5.9.2"},"_id":"@aargon-ui/radio@1.0.0-beta.1","gitHead":"92091459196e85a243093de4c3c95c8ef84026c3","_nodeVersion":"22.16.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-+VHnpoAyrpWrj4chQA41rhYpCL3A12bsyo9t3sx25JUnZoYSnBTLb0P3AWzlW9ASc/gFlMyfRfWwDHyCdvVetA==","shasum":"b81e348467e4360082705d619ce37383f493502d","tarball":"https://registry.npmjs.org/@aargon-ui/radio/-/radio-1.0.0-beta.1.tgz","fileCount":14,"unpackedSize":57018,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCSiPWg2KC9sFBAiafa8mREYKbH/XDlXvZuEp/qjrrVdwIhALGCXniuwR1eG9dEY5lwQd4SLMXbMmnDNMWCeYLba6hJ"}]},"_npmUser":{"name":"aargon007","email":"muhaiminul032@gmail.com"},"directories":{},"maintainers":[{"name":"aargon007","email":"muhaiminul032@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/radio_1.0.0-beta.1_1759206614726_0.6829177441803975"},"_hasShrinkwrap":false}},"time":{"created":"2025-09-30T04:30:14.654Z","1.0.0-beta.1":"2025-09-30T04:30:14.948Z","modified":"2025-09-30T04:30:15.260Z"},"maintainers":[{"name":"aargon007","email":"muhaiminul032@gmail.com"}],"description":"Animated radio component for React Native","homepage":"https://github.com/aargon007/aargon-ui/packages/radio#readme","keywords":["react-native","radio","animated","ui","component"],"repository":{"type":"git","url":"git+https://github.com/aargon007/aargon-ui.git","directory":"packages/radio"},"author":{"name":"Md Muhaiminul"},"bugs":{"url":"https://github.com/aargon007/aargon-ui/issues"},"license":"MIT","readme":"# Aargon Radio\r\n\r\nA highly customizable, animated radio button component for React Native with smooth animations and modern design.\r\n\r\n[![npm version](https://badge.fury.io/js/@aargon-ui/radio.svg)](https://www.npmjs.com/package/@aargon-ui/radio)\r\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\r\n\r\n## Features\r\n\r\n- 🎨 **Multiple Variants** - Default, filled, and outlined styles\r\n- 📏 **Size Options** - Small, medium, and large sizes\r\n- ⚡ **Smooth Animations** - Spring, timing, and bounce animations\r\n- 🎯 **Accessibility** - Full accessibility support with proper ARIA attributes\r\n- 🎨 **Customizable Themes** - Complete theming system with colors and styling\r\n- 🔧 **Flexible API** - Easy to use with comprehensive props\r\n- 📱 **React Native** - Built specifically for React Native with Reanimated\r\n- 🌟 **TypeScript** - Full TypeScript support with comprehensive types\r\n\r\n## Installation\r\n\r\n```bash\r\nnpm install @aargon-ui/radio\r\n# or\r\nyarn add @aargon-ui/radio\r\n```\r\n\r\n### Peer Dependencies\r\n\r\nMake sure you have the required peer dependencies installed:\r\n\r\n```bash\r\nnpm install react react-native react-native-reanimated\r\n```\r\n\r\n## Quick Start\r\n\r\n```tsx\r\nimport React, { useState } from 'react';\r\nimport { View, Text } from 'react-native';\r\nimport { AnimatedRadio } from '@aargon-ui/radio';\r\n\r\nexport default function App() {\r\n    const [selectedValue, setSelectedValue] = useState('');\r\n\r\n    return (\r\n        <View>\r\n            <AnimatedRadio value=\"option1\" selectedValue={selectedValue} onPress={() => setSelectedValue('option1')}>\r\n                <Text>Option 1</Text>\r\n            </AnimatedRadio>\r\n        </View>\r\n    );\r\n}\r\n```\r\n\r\n## Basic Usage\r\n\r\n### Simple Radio Button\r\n\r\n```tsx\r\nconst [selectedValue, setSelectedValue] = useState('');\r\n\r\n<AnimatedRadio value=\"option1\" selectedValue={selectedValue} onPress={() => setSelectedValue('option1')}>\r\n    <Text>Option 1</Text>\r\n</AnimatedRadio>;\r\n```\r\n\r\n### Without Label\r\n\r\n```tsx\r\n<AnimatedRadio value=\"option1\" selectedValue={selectedValue} onPress={() => setSelectedValue('option1')} />\r\n```\r\n\r\n### Radio Group\r\n\r\n```tsx\r\nconst [selectedValue, setSelectedValue] = useState('');\r\n\r\n<View>\r\n    <AnimatedRadio value=\"option1\" selectedValue={selectedValue} onPress={() => setSelectedValue('option1')}>\r\n        <Text>Option 1</Text>\r\n    </AnimatedRadio>\r\n    <AnimatedRadio value=\"option2\" selectedValue={selectedValue} onPress={() => setSelectedValue('option2')}>\r\n        <Text>Option 2</Text>\r\n    </AnimatedRadio>\r\n</View>;\r\n```\r\n\r\n## Variants\r\n\r\n### Default Variant\r\n\r\n```tsx\r\n<AnimatedRadio variant=\"default\">Default</AnimatedRadio>\r\n```\r\n\r\n### Filled Variant\r\n\r\n```tsx\r\n<AnimatedRadio variant=\"filled\">Filled</AnimatedRadio>\r\n```\r\n\r\n### Outlined Variant\r\n\r\n```tsx\r\n<AnimatedRadio variant=\"outlined\">Outlined</AnimatedRadio>\r\n```\r\n\r\n## Sizes\r\n\r\n```tsx\r\n<AnimatedRadio size=\"sm\">Small</AnimatedRadio>\r\n<AnimatedRadio size=\"md\">Medium</AnimatedRadio>\r\n<AnimatedRadio size=\"lg\">Large</AnimatedRadio>\r\n```\r\n\r\n## Animation Types\r\n\r\n### Spring Animation (Default)\r\n\r\n```tsx\r\n<AnimatedRadio animationType=\"spring\">Spring</AnimatedRadio>\r\n```\r\n\r\n### Timing Animation\r\n\r\n```tsx\r\n<AnimatedRadio animationType=\"timing\" duration={500}>\r\n    Timing\r\n</AnimatedRadio>\r\n```\r\n\r\n### Bounce Animation\r\n\r\n```tsx\r\n<AnimatedRadio animationType=\"bounce\">Bounce</AnimatedRadio>\r\n```\r\n\r\n## Custom Styling\r\n\r\n### Custom Theme\r\n\r\n```tsx\r\nconst customTheme = {\r\n    colors: {\r\n        background: '#3B82F6',\r\n        border: '#1D4ED8',\r\n        selected: '#FFFFFF',\r\n    },\r\n    borderRadius: 12,\r\n};\r\n\r\n<AnimatedRadio theme={customTheme}>Custom Theme</AnimatedRadio>;\r\n```\r\n\r\n### With Shadow\r\n\r\n```tsx\r\n<AnimatedRadio shadow={true}>With Shadow</AnimatedRadio>\r\n```\r\n\r\n## Advanced Usage\r\n\r\n### Disabled State\r\n\r\n```tsx\r\n<AnimatedRadio disabled={true}>Disabled</AnimatedRadio>\r\n```\r\n\r\n### Custom Selected Indicator\r\n\r\n```tsx\r\n<AnimatedRadio\r\n    customSelectedIndicator={<Text>✓</Text>}\r\n    value=\"option1\"\r\n    selectedValue={selectedValue}\r\n    onPress={() => setSelectedValue('option1')}>\r\n    Custom Indicator\r\n</AnimatedRadio>\r\n```\r\n\r\n### Radio Group with Array\r\n\r\n```tsx\r\nconst options = [\r\n    { label: 'Option 1', value: '1' },\r\n    { label: 'Option 2', value: '2' },\r\n    { label: 'Option 3', value: '3' },\r\n];\r\n\r\nconst [selectedValue, setSelectedValue] = useState('');\r\n\r\n{\r\n    options.map(option => (\r\n        <AnimatedRadio key={option.value} value={option.value} selectedValue={selectedValue} onPress={() => setSelectedValue(option.value)}>\r\n            <Text>{option.label}</Text>\r\n        </AnimatedRadio>\r\n    ));\r\n}\r\n```\r\n\r\n## API Reference\r\n\r\n### Props\r\n\r\n| Prop                      | Type                                  | Default     | Description                           |\r\n| ------------------------- | ------------------------------------- | ----------- | ------------------------------------- |\r\n| `children`                | `React.ReactNode`                     | -           | Label content                         |\r\n| `value`                   | `string`                              | -           | Value of the radio button             |\r\n| `selectedValue`           | `string`                              | -           | Currently selected value              |\r\n| `onPress`                 | `() => void`                          | -           | Function called when radio is pressed |\r\n| `variant`                 | `\"default\" \\| \"filled\" \\| \"outlined\"` | `\"default\"` | Visual variant                        |\r\n| `size`                    | `\"sm\" \\| \"md\" \\| \"lg\"`                | `\"md\"`      | Size of the radio button              |\r\n| `animationType`           | `\"timing\" \\| \"spring\" \\| \"bounce\"`    | `\"spring\"`  | Type of animation                     |\r\n| `duration`                | `number`                              | `300`       | Animation duration in milliseconds    |\r\n| `disabled`                | `boolean`                             | `false`     | Whether the radio is disabled         |\r\n| `customSelectedIndicator` | `React.ReactNode`                     | -           | Custom selected indicator element     |\r\n| `theme`                   | `RadioTheme`                          | -           | Custom theme object                   |\r\n| `shadow`                  | `boolean`                             | `false`     | Whether to show shadow effect         |\r\n\r\n### Types\r\n\r\n```tsx\r\ninterface RadioTheme {\r\n    colors: {\r\n        background: string;\r\n        border: string;\r\n        selected: string;\r\n        shadow: string;\r\n    };\r\n    borderRadius: number;\r\n    fontFamily?: string;\r\n}\r\n\r\ntype RadioVariant = 'default' | 'filled' | 'outlined';\r\ntype RadioSize = 'sm' | 'md' | 'lg';\r\ntype AnimationType = 'timing' | 'spring' | 'bounce';\r\n```\r\n\r\n## Accessibility\r\n\r\nThe radio component includes full accessibility support:\r\n\r\n- **ARIA attributes** - Proper `role=\"radio\"` and `aria-checked` attributes\r\n- **Keyboard navigation** - Supports keyboard interaction\r\n- **Screen reader support** - Announces state changes to screen readers\r\n- **Focus management** - Proper focus handling for keyboard users\r\n\r\n## Requirements\r\n\r\n- React Native 0.81.0+\r\n- React 19.0.0+\r\n- react-native-reanimated 3.0.0+\r\n\r\n## Contributing\r\n\r\nContributions are welcome! Please feel free to submit a Pull Request.\r\n\r\n## License\r\n\r\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\r\n\r\n## Support\r\n\r\nIf you have any questions or need help, please:\r\n\r\n1. Check the [documentation](https://github.com/aargon007/aargon-ui#readme)\r\n2. Search [existing issues](https://github.com/aargon007/aargon-ui/issues)\r\n3. Create a [new issue](https://github.com/aargon007/aargon-ui/issues/new)\r\n\r\n## Changelog\r\n\r\nSee [CHANGELOG.md](CHANGELOG.md) for a list of changes and version history.\r\n\r\n---\r\n\r\nMade with ❤️ by [Aargon](https://github.com/aargon007)\r\n","readmeFilename":"README.md","_rev":"1-999760e52a743e98f8e5ab8d47465517"}