feat: onSelectionChange

kirillzyusko commented 2 months ago

📜 Description

Added a new onSelectionChange handler for useFocusedInputHandler hook.

💡 Motivation and Context

These changes will be a findamental work for resolving https://github.com/kirillzyusko/react-native-keyboard-controller/issues/420

To get onSelectionChange events I had to intercept them:

on iOS it's possible on a delegate level (since default delegate forwards all events to JS I had to carefully intercept all events and forward them to original delegate - that's why I create KCTextInputCompositeDelegate (KC stands for KeyboardController);
on Android I can inject my own handler, but turned out that on Fabric hanlder is re-created on each symbol typing, so my handler gets overwritten by handler from props - that's why I added FrameScheduler class and went with "long pooling" approach (later on I plan to add addSelectionListener method to RN core);

Last but not least - interaction with the proxy-delegate will give us an ability to intercept more events, so we may get rid off patch for react-native-text-input-mask and get events directly from the delegate.

📢 Changelog

Docs

added a reference about new handler and its use cases;

E2E

updated e2e test suite (covered new functionality);

JS

added new event tye declaration;
added new internal hook (useFocusedInputSelectionHandler);
added new unit tests;
updated fabric specs;
update example app;
updated cspell config;

iOS

added KCTextInputCompositeDelegate;
added setForceDelegate extension for RCTUITextView;
added new event;

Android

added FrameScheduler class;
added extension for observing selection changes;
added new event;

🤔 How Has This Been Tested?

Tested on:

Pixel 7 Pro (Android 14, real device);
Pixel 3A (Androd 13, emulator);
iPhone 15 Pro (simulator, iOS 17.4);
iPhone 11 (iOS 17.4.1, real devcie).

📸 Screenshots (if appropriate):

📝 Checklist

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

github-actions[bot] commented 2 months ago

📊 Package size report

Current size	Target Size	Difference
136031 bytes	131465 bytes	4566 bytes 📈

github-actions[bot] commented 2 months ago

PR Preview Action v1.4.7 :---: :rocket: Deployed preview to https://kirillzyusko.github.io/react-native-keyboard-controller/pr-preview/pr-426/ on branch gh-pages at 2024-05-07 12:12 UTC

argos-ci[bot] commented 2 months ago

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

Build	Status	Details	Updated (UTC)
default (Inspect)	✅ No change detected	-	May 8, 2024, 9:22 AM

kirillzyusko / react-native-keyboard-controller