feat!: build a complete cross-platform rating system

[f0rr0]

What ships

This is the single integrated next-version change: no intermediate component, compatibility layer, or partial release.

• Rebuilds Rating around one exact integer-tick model for fractional input, min, clearing, pointer geometry, keyboard/accessibility actions, controlled state, visual fill, and callback deduplication.
• Adds deliberate tap-and-drag interaction that waits for axis intent, yields cross-axis scrolling, uses stable page-coordinate geometry, handles release revalidation/multi-touch/termination, and keeps a local controlled draft.
• Adds allocation-light RatingDisplay for exact aggregates and list cells.
• Adds generic RatingScale for NPS, Likert, emoji, strings, zero, negative values, null empty state, reversal, cumulative/single visuals, and readable item extents.
• Adds native adjustable semantics plus a complete React Native Web ARIA slider/keyboard/focus implementation, reduced-motion-aware completion feedback, explicit RTL/vertical behavior, and decorative static semantics.
• Makes renderer ownership explicit, strips conflicting responder/accessibility/root props at both type and runtime boundaries, and hardens invalid values/layout inputs before native styles are built.
• Ships a polished Expo example, v4 migration guide, dated competitor/source/issue analysis, SEO/package discovery copy, and CI gates for the packed artifact.

Verified need and positioning

The research snapshot is dated 2026-07-28 and covers recurring results across the first-two-page depth for four rating-component query families, current package metadata, exact competitor release source, and open/historical issue evidence. Search ordering is volatile and the research surface did not expose stable locale/rank metadata, so the analysis presents an honest recurring-hit sample rather than a fabricated ranking.

The implementation borrows the useful category lessons—separate static rendering, explicit interaction lifecycle, and visual customization—while differentiating on the combination competitors do not provide: scroll-aware drag intent, one end-to-end fractional model, native/Web accessibility parity, a real static path, semantic scales, explicit locale/orientation/reversal semantics, core-only adoption, defensive boundaries, and duplicate-semantic control.

See:

• Competitive analysis
• Architecture and integrated release plan
• README migration and full API guide

Backlog disposition

• Closes the verified fractional-fill request in Support for half starFilled #4.
• Closes the custom element/rendering request in Feature: support for passing element instead of images. #8.
• Closes obsolete Greenkeeper setup issue Action required: Greenkeeper could not be activated 🚨 #10; current dependency automation and Release Please replace it.
• Closes the concrete minimum-rating use case from Disable stars at given indexes #13 with min; sparse holes are intentionally not introduced into slider semantics.
• Closes the FlatList use case in How To Get Rating if i have FlatList of React-native rating ? #14 with keyed controlled guidance and the static RatingDisplay path.
• Supersedes the conflicting legacy implementations in PRs Added ability to update stars rating outside the component #9 and Allow component to be passed as props for selected and unselected stars #11 with controlled values and typed render slots.
• Intentionally excludes PR chore(deps): bump the dependencies group across 1 directory with 3 updates #18: its Jest 30 runtime currently fails against the React Native Jest 29 module-mocker generation, so it is not folded in merely because it is newer.

Closes #4
Closes #8
Closes #10
Closes #13
Closes #14

Breaking changes

Release Please should cut this as v4. Root responder/keyboard/accessibility ownership, primary-axis item geometry, default visuals/colors, Web focus behavior, and vertical progression are deliberately tightened. The migration section documents every required adjustment. Existing controlled value/onChange and uncontrolled defaultValue concepts remain.

Validation

• bun run check
  • formatting, Oxlint, TypeScript
  • 7 Jest suites / 76 tests
  • 94.01% statements, 90.31% branches, 96.26% functions, 94.08% lines
  • Bob build, strict Publint, Are the Types Wrong
  • hook config, ShellCheck, Actionlint, and Zizmor
• Packed-tarball consumer compile and ESM/CommonJS resolution on:
  • minimum React 19.1.1 / React Native 0.82.0
  • current React 19.2.8 / React Native 0.86.2
• Clean packed-package Expo 57 project:
  • TypeScript
  • production Web export
  • React Native Web server rendering for Rating, RatingDisplay, and RatingScale
  • ARIA, decorative semantics, registered pointer-routing CSS, and zero render diagnostics
• Independent final API/accessibility/performance review found no material source-level blockers.

The PR remains draft for the documented real-device/browser manual VoiceOver, TalkBack, keyboard, ScrollView, RTL, and release-mode list profiling pass before merge.