Skip to content

Changelog

v0.4.2 Patch Release
2026-09-21
  • FIX Progress Animation Memory Leak: Added cancelAnimation cleanup to the Progress component 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>deg and NaNdeg errors that caused fatal React Native transform parser exceptions.
  • PERF Ultra-Lightweight Spinner Execution: Extracted DotItem and BarItem as 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 Toast and DatePicker.
v0.4.0 Breaking Release
2026-09-19
  • REFACTOR Removed @gorhom/bottom-sheet Dependency: Completely removed @gorhom/bottom-sheet from peer dependencies and purged the BottomSheet wrapper to keep @masumdev/rn-ui lean and zero-dependency on external gesture bottom sheets.
  • REFACTOR Removed Sheet & Tabs Components: Deprecated and removed Sheet and Tabs components in favor of simpler native modal patterns and segmented controls.
  • FEAT Standalone Command Component: Refactored Command palette to use a self-contained modal overlay without requiring external Sheet abstractions.
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 onLayout bridge listeners, and added SkeletonGroup for 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, and soft variants. 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, TimePickerInput with wheel and calendar variants, locale support, and WheelPickerColumn.
  • FEAT ExpandableCalendar & AgendaList: Week/month expandable calendar with agenda list, powered by react-native-calendars. Includes CalendarProvider, WeekCalendar, and AgendaList.
  • FEAT TimelineCalendar: Day/week timeline view with packed events, powered by react-native-calendars. Includes TimelineList and CalendarUtils.
  • 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 LocaleConfig and getLocaleData utilities 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, subtle variants, safe area inset, and async toast.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 any type detection to bun 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 CircularProgress component supporting strokeLinecap="round" for Apple Watch-style rounded arc ends and centered percentage typography.
  • FEAT Carousel AutoPlay, Loop & Reanimated Dots: Added autoPlay, autoPlayInterval, and loop props to Carousel, alongside 60-120 FPS continuous scrollX interpolated CarouselDot indicator dots.
  • FEAT Calendar Event Dots & Today Quick Jump: Enhanced Calendar with 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 xl size (56px), shape options (circle, square, rounded), status badges (online, busy, away, offline), and stacked AvatarGroup with 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 CollapsibleContent by introducing an unconstrained off-screen height listener to guarantee persistent toggling.
  • FEAT Badge 6 Style Variants: Added subtle and ghost variants to Badge alongside solid, soft, outline, and glass.
  • FEAT Universal Glassmorphism (glass?: boolean): Added glass?: 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-haptics integration for Button, IconButton, Switch, Checkbox, Slider, Rating, and Accordion with press-down spring scale animations.
  • FEAT Form Validation Shake Motion: Added automatic horizontal error shake animation and haptic feedback to FormField when invalid state triggers.
  • REFACTOR Clean Base Component Interfaces: Exported BaseGlassProps, BaseHapticProps, BaseAnimatedProps, and BaseComponentProps in types.ts for 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, and BaseUIComponentProps from @masumdev/rn-ui.
  • REFACTOR Unified Component Inheritance: Refactored Button, IconButton, Badge, Alert, AlertDialog, FloatingActionButton, and Progress to consistently extend shared base prop interfaces.
  • REFACTOR Strict Type Safety Enforcement: Cleaned up internal implementations to achieve Zero any types across all components and event handlers.
  • DOCS Design System Rules & Custom Components Guide: Published RULES.md in 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 ThemeProvider with flat design tokens, dark mode support, and pluggable storage hydration.