Changelog
v0.4.2 Patch Release
2026-09-21
- FIX Progress Animation Memory Leak: Added
cancelAnimationcleanup to theProgresscomponent for both indeterminate (withRepeat) and determinate (withTiming) animation branches, preventing orphaned UI-thread worklets on unmount or prop changes.
v0.4.1 Patch Release
2026-09-21
- FIX Spinner / Loader Rotation Crash-Proofing: Implemented safe degree normalization worklet (
toSafeDeg) that strictly constrains rotation angles to finite positive values in[0, 360). Completely eliminated--<num>degandNaNdegerrors that caused fatal React Native transform parser exceptions. - PERF Ultra-Lightweight Spinner Execution: Extracted
DotItemandBarItemas memoized components outside render loops to eliminate React Hook rule violations and memory leaks. Implemented selective animation execution (rotation for circular/ring, pulse for dots/bars) to save UI thread cycles. - FIX Defensive SVG & Transform Bounds: Clamped dimensions and radii to strictly positive numbers to prevent invalid SVG circle rendering, and safeguarded rotation transforms across
ToastandDatePicker.
v0.4.0 Breaking Release
2026-09-19
- REFACTOR Removed @gorhom/bottom-sheet Dependency: Completely removed
@gorhom/bottom-sheetfrom peer dependencies and purged theBottomSheetwrapper to keep @masumdev/rn-ui lean and zero-dependency on external gesture bottom sheets. - REFACTOR Removed Sheet & Tabs Components: Deprecated and removed
SheetandTabscomponents in favor of simpler native modal patterns and segmented controls. - FEAT Standalone Command Component: Refactored
Commandpalette to use a self-contained modal overlay without requiring externalSheetabstractions.
v0.3.1 Feature Release
2026-09-12
- FEAT Spinner & Loader Components: Dedicated high-performance loader component with 4 distinct animation variants (
circular,ring,dots,bars), customizable speeds, size scales, semantic color tones, and descriptive labels. - PERF Ultra-Lightweight Skeleton with SkeletonGroup: Reduced SharedValues by 75%, removed native
onLayoutbridge listeners, and addedSkeletonGroupfor synchronized single-clock multi-skeleton screens with zero layout shift and safe unmount cleanup. - FIX Button & renderIcon Defensive Rendering: Safeguarded mixed children rendering to prevent un-wrapped text string errors in React Native and added automatic support for React forwardRef components.
v0.3.0 Feature Release
2026-08-25
- FEAT Chip & Tag Components: New selection chips with
filled,outline, andsoftvariants. Supports toggle selection, close buttons, icons, and tone theming. - FEAT DatePicker & TimePicker Suite: Full date/time picker system including
DatePicker,DatePickerCard,DatePickerModal,DatePickerDialog,DatePickerInput,TimePicker,TimePickerCard,TimePickerModal,TimePickerDialog,TimePickerInputwith wheel and calendar variants, locale support, andWheelPickerColumn. - FEAT ExpandableCalendar & AgendaList: Week/month expandable calendar with agenda list, powered by react-native-calendars. Includes
CalendarProvider,WeekCalendar, andAgendaList. - FEAT TimelineCalendar: Day/week timeline view with packed events, powered by react-native-calendars. Includes
TimelineListandCalendarUtils. - FEAT RangeSlider (Dual-Thumb): New dual-thumb range selection slider with direct 1:1 gesture tracking, snap-to-step, tone theming, and haptic feedback.
- FEAT SegmentedControl: iOS-style segmented tabs with fluid sliding pill animation, icon/badge support, and size/tone theming.
- FEAT SignaturePad: SVG-based drawing canvas for digital signatures with undo, clear, guide line, and
getSvg()export via ref. - FEAT SwipeableItem: Swipeable list rows with configurable left/right actions, full-swipe support, collapse-dismiss animation, and haptic feedback.
- FEAT RadioGroup Plain Variant: New
variant="plain"without container border for cleaner inline radio layouts. - FEAT Locale System: New
LocaleConfigandgetLocaleDatautilities for DatePicker, Calendar, and ExpandableCalendar i18n support. - CHORE Avatar Revamp: Added editable badge, profile editor patterns, and improved AvatarGroup with count indicators.
- CHORE Calendar Overhaul: Swipe navigation, locale system integration, event dots markers, fast month/year overlay selectors.
- CHORE Slider Direct Gesture Tracking: Replaced spring/timing animations with 1:1 touch tracking. Standardized thumb (24px, white, colored border).
- CHORE Switch Oval Variant: New
variant="oval"with rounded capsule styling and haptic integration. - CHORE Toast Variants & Promise Updates: Added
outlined,flat,subtlevariants, safe area inset, and asynctoast.update()in-place updates. - CHORE FormField 17-Primitive Showcase: Integrated all 17 form primitives (Input, InputGroup, RadioGroup, DatePicker, TimePicker, Chip, Slider, RangeSlider, Select, Combobox, InputOTP, Textarea, Rating, Switch, SignaturePad, Checkbox, FormField) with full Zod validation.
- CHORE Rating Gesture Improvements: Improved half-star precision tracking and gesture handling.
- REFACTOR Zero-Bounce Animation Policy: Established monorepo-wide rule prohibiting bouncy spring animations on interactive controls. All controls now use
withTiming(100-160ms) or direct gesture tracking. - REFACTOR Audit Script Upgrade: Added explicit
anytype detection tobun run audit. Output moved to.temp/tscheck/.
v0.2.0 Previous Release
2026-08-23
- FEAT SVG CircularProgress with Rounded Line Caps: Implemented SVG-based
CircularProgresscomponent supportingstrokeLinecap="round"for Apple Watch-style rounded arc ends and centered percentage typography. - FEAT Carousel AutoPlay, Loop & Reanimated Dots: Added
autoPlay,autoPlayInterval, andloopprops toCarousel, alongside 60-120 FPS continuousscrollXinterpolatedCarouselDotindicator dots. - FEAT Calendar Event Dots & Today Quick Jump: Enhanced
Calendarwith event dot indicators (marked/dots), quick "Today" header navigation button, ring today highlight, and fast month/year overlay selectors. - FEAT Avatar XL Size, Shapes & Status Indicators: Added
xlsize (56px), shape options (circle,square,rounded), status badges (online,busy,away,offline), and stackedAvatarGroupwith count indicator. - FEAT Toast Variants, Safe Area & Promise Updates: Added
ToastVariant(outlined,flat,subtle), safe area bottom inset padding, tone icon badges, action buttons, and async promise in-place updates (toast.update(...)). - FIX Collapsible Height Measurement & Zero Glitch: Eliminated layout position switching glitch in
CollapsibleContentby introducing an unconstrained off-screen height listener to guarantee persistent toggling. - FEAT Badge 6 Style Variants: Added
subtleandghostvariants toBadgealongsidesolid,soft,outline, andglass. - FEAT Universal Glassmorphism (
glass?: boolean): Addedglass?: boolean(default:false) across all surface/container components (Card,Box,Button,IconButton,Badge,Sheet,BottomSheet,Popover,Input,Accordion) featuring translucent frosted backgrounds and soft highlight borders. - FEAT Tactile Micro-Interactions & Haptic Engine: Safe optional
expo-hapticsintegration forButton,IconButton,Switch,Checkbox,Slider,Rating, andAccordionwith press-down spring scale animations. - FEAT Form Validation Shake Motion: Added automatic horizontal error shake animation and haptic feedback to
FormFieldwheninvalidstate triggers. - REFACTOR Clean Base Component Interfaces: Exported
BaseGlassProps,BaseHapticProps,BaseAnimatedProps, andBaseComponentPropsintypes.tsfor clean prop inheritance. - DOCS Dedicated 1-to-1 Showcase Pages: Restructured native playground app so all 53 UI components have focused, dedicated showcase routes.
v0.1.7 Previous Release
2026-08-23
- FEAT Exported Shared Base UI Interfaces: Exported
ToneProps,VariantProps,SizeProps,ShapeProps,IconSlotsProps, andBaseUIComponentPropsfrom@masumdev/rn-ui. - REFACTOR Unified Component Inheritance: Refactored
Button,IconButton,Badge,Alert,AlertDialog,FloatingActionButton, andProgressto consistently extend shared base prop interfaces. - REFACTOR Strict Type Safety Enforcement: Cleaned up internal implementations to achieve Zero
anytypes across all components and event handlers. - DOCS Design System Rules & Custom Components Guide: Published
RULES.mdin the library package and created the Building Custom Components guide.
v0.1.0 Initial Release
2026-08-22
- FEAT Initial release of
@masumdev/rn-ui. - FEAT Added 55+ production-grade React Native UI components:
Button,Avatar,Badge,BottomSheet,Toast,Card,FormField,Select,Input,Box,Text, and more. - FEAT Built-in
ThemeProviderwith flat design tokens, dark mode support, and pluggable storage hydration.