feat: keyboard state selector

[kirillzyusko]

📜 Description

Added ability to pass selector to useKeyboardState hook to query only necessary updates.

💡 Motivation and Context

The concept of selectors should be very familiar to many RN developers, since it's used in redux and zustand packages. I was also thinking about optimizing the amount of re-renders for this hook, but initially I've been thinking of using proxy (similar to what react-hook-form is doing). But such approach will introduce a lot of complexity, so I decided to keep the codebase simple and efficient, so added a concept of selectors.

Additionally I re-worked documnetation mainly focusing on:

• adding a sample how useKeyboardAnimation can be used as alternative;
• making warnings/tips shorter with corresponding references;
• adding the usage for selectors concept;
• use a real-world example with useKeyboardState (conditional rendering instead of changing styles).

📢 Changelog

JS

• allow to pass selectors to useKeyboardState;

Docs

• make warning/tips shorter with corresponding links;
• added useKeyboardState vs useKeyboardAnimation code reference;
• mention how to use selectors;
• re-work example app to match real-world scenarios usage.

🤔 How Has This Been Tested?

Tested manually in example project.

📸 Screenshots (if appropriate):

Dark theme	Light theme

📝 Checklist

• CI successfully passed
• I added new mocks and corresponding unit-tests if library API was changed

[github-actions]

📊 Package size report

Current size	Target Size	Difference
211103 bytes	210267 bytes	836 bytes 📈

[github-actions]

PR Preview Action v1.6.1
🚀 View preview at https://kirillzyusko.github.io/react-native-keyboard-controller/pr-preview/pr-998/
Built to branch gh-pages at 2025-06-30 18:12 UTC. Preview will be ready when the GitHub Pages deployment is complete.

[argos-ci]

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build	Status	Details	Updated (UTC)
default (Inspect)	👍 Changes approved	1 changed	Jun 30, 2025, 6:15 PM