[0.76] [TextInput] Export TI State's focusInput/blurInput (#2464)

[These two
functions](https://github.com/microsoft/react-native-macos/blob/9ea059c33143e6766582a1f682e4f144e00cc740/packages/react-native/Libraries/Components/TextInput/TextInputState.js#L60C1-L70C2)
are used to [properly handle onFocus\onBlur for TextInput
implementations](https://github.com/microsoft/react-native-macos/blob/9ea059c33143e6766582a1f682e4f144e00cc740/packages/react-native/Libraries/Components/TextInput/TextInput.js#L1623C1-L1635C5),
specifically they are used to track the currently focused TextInput
control and as such cause
[focusTextInput](https://github.com/microsoft/react-native-macos/blob/9ea059c33143e6766582a1f682e4f144e00cc740/packages/react-native/Libraries/Components/TextInput/TextInputState.js#L106C1-L106C48)
and
[blurTextInput](https://github.com/microsoft/react-native-macos/blob/9ea059c33143e6766582a1f682e4f144e00cc740/packages/react-native/Libraries/Components/TextInput/TextInputState.js#L143C1-L143C69)
to skip native focus\blur calls if the JS side thinks the control in
question is already focused\blurred.

In other words, if someone wants to build a custom `<TextInput>` from
the ground up, they can't expect `focusTextInput`, `blurTextInput`, and
`currentlyFocusedInput` (the last one which is especially already used
in a bunch of places in the framework) to work properly. This change
exports the necessary `focusInput` and `blurInput` out of
[TextInput](https://github.com/microsoft/react-native-macos/blob/9ea059c33143e6766582a1f682e4f144e00cc740/packages/react-native/Libraries/Components/TextInput/TextInput.js#L2041C1-L2048C3)
statics.

Co-authored-by: Saad Najmi <[email protected]>

Author: nakambo

packages/react-native/Libraries/Components/TextInput/TextInput.d.ts

@@ -1059,6 +1059,22 @@ interface TextInputState {
    * noop if it wasn't focused
    */
   blurTextInput(textField?: React.ElementRef<HostComponent<unknown>>): void;
+
+  // [macOS
+  /**
+   * @param textField ref of the text field that was focused
+   * Call on custom implementations of TextInput to notify the control was focused
+   * noop if it was already focused
+   */
+  onTextInputFocus(textField?: React.ElementRef<HostComponent<unknown>>): void;
+
+  /**
+   * @param textField ref of the text field that was blurred
+   * Call on custom implementations of TextInput to notify the control was blurred
+   * noop if it wasn't focused
+   */
+  onTextInputBlur(textField?: React.ElementRef<HostComponent<unknown>>): void;
+  // macOS]
 }
 
 /**

packages/react-native/Libraries/Components/TextInput/TextInput.flow.js

@@ -1223,6 +1223,8 @@ export type TextInputComponentStatics = $ReadOnly<{|
     currentlyFocusedField: () => ?number,
     focusTextInput: (textField: ?ComponentRef) => void,
     blurTextInput: (textField: ?ComponentRef) => void,
+    onTextInputFocus: (textField: ?ComponentRef) => void, // [macOS]
+    onTextInputBlur: (textField: ?ComponentRef) => void, // [macOS]
   |}>,
 |}>;
 

packages/react-native/Libraries/Components/TextInput/TextInput.js

@@ -2013,6 +2013,8 @@ ExportedForwardRef.State = {
   currentlyFocusedField: TextInputState.currentlyFocusedField,
   focusTextInput: TextInputState.focusTextInput,
   blurTextInput: TextInputState.blurTextInput,
+  onTextInputFocus: TextInputState.focusInput, // [macOS]
+  onTextInputBlur: TextInputState.blurInput, // [macOS]
 };
 
 export type TextInputComponentStatics = $ReadOnly<{|
@@ -2021,6 +2023,8 @@ export type TextInputComponentStatics = $ReadOnly<{|
     currentlyFocusedField: typeof TextInputState.currentlyFocusedField,
     focusTextInput: typeof TextInputState.focusTextInput,
     blurTextInput: typeof TextInputState.blurTextInput,
+    onTextInputFocus: typeof TextInputState.focusInput, // [macOS]
+    onTextInputBlur: typeof TextInputState.blurInput, // [macOS]
   |}>,
 |}>;
 

packages/react-native/Libraries/__tests__/__snapshots__/public-api-test.js.snap

@@ -3164,6 +3164,8 @@ export type TextInputComponentStatics = $ReadOnly<{|
     currentlyFocusedField: () => ?number,
     focusTextInput: (textField: ?ComponentRef) => void,
     blurTextInput: (textField: ?ComponentRef) => void,
+    onTextInputFocus: (textField: ?ComponentRef) => void,
+    onTextInputBlur: (textField: ?ComponentRef) => void,
   |}>,
 |}>;
 export type TextInputType = React.AbstractComponent<
@@ -3553,6 +3555,8 @@ export type TextInputComponentStatics = $ReadOnly<{|
     currentlyFocusedField: typeof TextInputState.currentlyFocusedField,
     focusTextInput: typeof TextInputState.focusTextInput,
     blurTextInput: typeof TextInputState.blurTextInput,
+    onTextInputFocus: typeof TextInputState.focusInput,
+    onTextInputBlur: typeof TextInputState.blurInput,
   |}>,
 |}>;
 declare module.exports: TextInputType;