react-native-tvos 0.72.4-0rc1 → 0.72.6-0

package/types/public/ReactNativeTVTypes.d.ts

@@ -0,0 +1,192 @@
+import React from 'react';
+import { ViewProps, ScrollViewProps } from 'react-native';
+
+declare module 'react-native' {
+  interface ViewProps {
+  /**
+   * TV next focus down (see documentation for the View component).
+   */
+  nextFocusDown?: number,
+
+  /**
+   * TV next focus forward (see documentation for the View component).
+   *
+   * @platform android
+   */
+  nextFocusForward?: number,
+
+  /**
+   * TV next focus left (see documentation for the View component).
+   */
+  nextFocusLeft?: number,
+
+  /**
+   * TV next focus right (see documentation for the View component).
+   */
+  nextFocusRight?: number,
+
+  /**
+   * TV next focus up (see documentation for the View component).
+   */
+  nextFocusUp?: number,
+  }
+
+  export interface NativeMethods {
+    requestTVFocus(): void;
+  }
+
+  export const useTVEventHandler: (handleEvent: (event: HWEvent) => void) => void;
+
+  export const TVEventControl: {
+    enableTVMenuKey(): void;
+    disableTVMenuKey(): void;
+    enableTVPanGesture(): void;
+    disableTVPanGesture(): void;
+    enableGestureHandlersCancelTouches(): void;
+    disableGestureHandlersCancelTouches(): void;
+  };
+
+  export type HWEvent = {
+    eventType: 'up' | 'down' | 'right' | 'left' | 'longUp' | 'longDown' | 'longRight' | 'longLeft' | 'blur' | 'focus' | 'pan' | string;
+    eventKeyAction?: -1 | 1 | 0 | number;
+    tag?: number;
+    body?: {
+      state: "Began" | "Changed" | "Ended",
+      x: number,
+      y: number,
+      velocityx: number,
+      velocityy: number
+    }
+  };
+
+  export class TVEventHandler {
+    enable<T extends React.Component<unknown>>(
+      component?: T,
+      callback?: (component: T, data: HWEvent) => void
+    ): void;
+    disable(): void;
+  }
+
+  export interface FocusGuideProps extends ViewProps {
+     /**
+     * If the view should be "visible". display "flex" if visible, otherwise "none".
+     * Defaults to true
+     */
+    enabled?: boolean;
+    /**
+     * Array of `Component`s to register as destinations with `UIFocusGuide`
+     */
+    destinations?: (null | number | React.Component<any, any> | React.ComponentClass<any>)[];
+    /**
+     * If true, `TVFocusGuide` will automatically manage focus for you.
+     * It will redirect the focus to the first focusable child on the first visit.
+     * It also remembers the last focused child and redirects the focus
+     * to it on the subsequent visits.
+     *
+     * `destinations` prop takes precedence over this prop when used together.
+     *
+     * @default false
+     */
+    autoFocus?: boolean;
+    /**
+     * Enables focus trapping for the focus guide (see README).
+     */
+    trapFocusUp?: boolean;
+    /**
+     * Enables focus trapping for the focus guide (see README).
+     */
+    trapFocusDown?: boolean;
+    /**
+     * Enables focus trapping for the focus guide (see README).
+     */
+    trapFocusLeft?: boolean;
+    /**
+     * Enables focus trapping for the focus guide (see README).
+     */
+    trapFocusRight?: boolean;
+    /**
+     * @deprecated Don't use it, no longer necessary.
+     */
+    safePadding?: 'both' | 'vertical' | 'horizontal' | null;
+  }
+
+  export type FocusGuideMethods = {
+    setDestinations: (
+      destinations: (React.ElementRef<HostComponent<unknown>> | null | undefined)[],
+    ) => void;
+  }
+
+  /**
+   * This component provides support for Apple's `UIFocusGuide` API,
+   * to help ensure that focusable controls can be navigated to,
+   * even if they are not directly in line with other controls on both tvOS and Android.
+   * An example is provided in `RNTester` that shows different ways of using this component.
+   * https://github.com/react-native-tvos/react-native-tvos/blob/tvos-v0.69.8/packages/rn-tester/js/examples/TVFocusGuide/TVFocusGuideAutoFocusExample.js
+   */
+  export const TVFocusGuideView: React.ForwardRefExoticComponent<FocusGuideProps & React.RefAttributes<View & FocusGuideMethods>>;
+  export interface TVTextScrollViewProps extends ScrollViewProps {
+    /**
+     * The duration of the scroll animation when a swipe is detected.
+     * Default value is 0.3 s
+     */
+    scrollDuration?: number;
+    /**
+     * Scrolling distance when a swipe is detected
+     * Default value is half the visible height (vertical scroller)
+     * or width (horizontal scroller)
+     */
+    pageSize?: number;
+    /**
+     * If true, will scroll to start when focus moves out past the beginning
+     * of the scroller
+     * Defaults to true
+     */
+    snapToStart?: boolean;
+    /**
+     * If true, will scroll to end when focus moves out past the end of the
+     * scroller
+     * Defaults to true
+     */
+    snapToEnd?: boolean;
+    /**
+     * Called when the scroller comes into focus (e.g. for highlighting)
+     */
+    onFocus?(evt: HWEvent): void;
+    /**
+     * Called when the scroller goes out of focus
+     */
+    onBlur?(evt: HWEvent): void;
+  }
+
+  export class TVTextScrollView extends React.Component<TVTextScrollViewProps> {}
+
+  export interface PressableStateCallbackType {
+    readonly focused: boolean;
+  }
+
+  export interface TouchableWithoutFeedbackPropsIOS {
+    /**
+     * *(Apple TV only)* TV preferred focus (see documentation for the View component).
+     *
+     * @platform ios
+     */
+    hasTVPreferredFocus?: boolean;
+
+    /**
+     * *(Apple TV only)* Object with properties to control Apple TV parallax effects.
+     *
+     * enabled: If true, parallax effects are enabled.  Defaults to true.
+     * shiftDistanceX: Defaults to 2.0.
+     * shiftDistanceY: Defaults to 2.0.
+     * tiltAngle: Defaults to 0.05.
+     * magnification: Defaults to 1.0.
+     * pressMagnification: Defaults to 1.0.
+     * pressDuration: Defaults to 0.3.
+     * pressDelay: Defaults to 0.0.
+     *
+     * @platform ios
+     */
+    tvParallaxProperties?: TVParallaxProperties;
+  }
+
+}

package/ReactAndroid/src/main/java/com/facebook/react/ReactAndroidHWInputDeviceHelper.java

@@ -1,98 +0,0 @@
-/*
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-package com.facebook.react;
-
-import android.view.KeyEvent;
-import android.view.View;
-import com.facebook.react.bridge.WritableMap;
-import com.facebook.react.bridge.WritableNativeMap;
-import com.facebook.react.common.MapBuilder;
-import java.util.Map;
-
-/** Responsible for dispatching events specific for hardware inputs. */
-public class ReactAndroidHWInputDeviceHelper {
-
-  /**
-   * Contains a mapping between handled KeyEvents and the corresponding navigation event that should
-   * be fired when the KeyEvent is received.
-   */
-  private static final Map<Integer, String> KEY_EVENTS_ACTIONS =
-      MapBuilder.<Integer, String>builder()
-          .put(KeyEvent.KEYCODE_DPAD_CENTER, "select")
-          .put(KeyEvent.KEYCODE_ENTER, "select")
-          .put(KeyEvent.KEYCODE_SPACE, "select")
-          .put(KeyEvent.KEYCODE_MEDIA_PLAY_PAUSE, "playPause")
-          .put(KeyEvent.KEYCODE_MEDIA_REWIND, "rewind")
-          .put(KeyEvent.KEYCODE_MEDIA_FAST_FORWARD, "fastForward")
-          .put(KeyEvent.KEYCODE_MEDIA_STOP, "stop")
-          .put(KeyEvent.KEYCODE_MEDIA_NEXT, "next")
-          .put(KeyEvent.KEYCODE_MEDIA_PREVIOUS, "previous")
-          .put(KeyEvent.KEYCODE_DPAD_UP, "up")
-          .put(KeyEvent.KEYCODE_DPAD_RIGHT, "right")
-          .put(KeyEvent.KEYCODE_DPAD_DOWN, "down")
-          .put(KeyEvent.KEYCODE_DPAD_LEFT, "left")
-          .put(KeyEvent.KEYCODE_INFO, "info")
-          .put(KeyEvent.KEYCODE_MENU, "menu")
-          .build();
-
-  /**
-   * We keep a reference to the last focused view id so that we can send it as a target for key
-   * events and be able to send a blur event when focus changes.
-   */
-  private int mLastFocusedViewId = View.NO_ID;
-
-  private final ReactRootView mReactRootView;
-
-  ReactAndroidHWInputDeviceHelper(ReactRootView mReactRootView) {
-    this.mReactRootView = mReactRootView;
-  }
-
-  /** Called from {@link ReactRootView}. This is the main place the key events are handled. */
-  public void handleKeyEvent(KeyEvent ev) {
-    int eventKeyCode = ev.getKeyCode();
-    int eventKeyAction = ev.getAction();
-    if ((eventKeyAction == KeyEvent.ACTION_UP || eventKeyAction == KeyEvent.ACTION_DOWN)
-        && KEY_EVENTS_ACTIONS.containsKey(eventKeyCode)) {
-      dispatchEvent(KEY_EVENTS_ACTIONS.get(eventKeyCode), mLastFocusedViewId, eventKeyAction);
-    }
-  }
-
-  /** Called from {@link ReactRootView} when focused view changes. */
-  public void onFocusChanged(View newFocusedView) {
-    if (mLastFocusedViewId == newFocusedView.getId()) {
-      return;
-    }
-    if (mLastFocusedViewId != View.NO_ID) {
-      dispatchEvent("blur", mLastFocusedViewId);
-    }
-    mLastFocusedViewId = newFocusedView.getId();
-    dispatchEvent("focus", newFocusedView.getId());
-  }
-
-  /** Called from {@link ReactRootView} when the whole view hierarchy looses focus. */
-  public void clearFocus() {
-    if (mLastFocusedViewId != View.NO_ID) {
-      dispatchEvent("blur", mLastFocusedViewId);
-    }
-    mLastFocusedViewId = View.NO_ID;
-  }
-
-  private void dispatchEvent(String eventType, int targetViewId) {
-    dispatchEvent(eventType, targetViewId, -1);
-  }
-
-  private void dispatchEvent(String eventType, int targetViewId, int eventKeyAction) {
-    WritableMap event = new WritableNativeMap();
-    event.putString("eventType", eventType);
-    event.putInt("eventKeyAction", eventKeyAction);
-    if (targetViewId != View.NO_ID) {
-      event.putInt("tag", targetViewId);
-    }
-    mReactRootView.sendEvent("onHWKeyEvent", event);
-  }
-}

package/scripts/cocoapods/__tests__/codegen-test.rb

@@ -1,242 +0,0 @@
-# Copyright (c) Meta Platforms, Inc. and affiliates.
-#
-# This source code is licensed under the MIT license found in the
-# LICENSE file in the root directory of this source tree.
-
-require "test/unit"
-require_relative "../codegen.rb"
-require_relative "./test_utils/PodMock.rb"
-require_relative "./test_utils/PathnameMock.rb"
-require_relative "./test_utils/FileMock.rb"
-require_relative "./test_utils/DirMock.rb"
-require_relative "./test_utils/systemUtils.rb"
-require_relative "./test_utils/CodegenUtilsMock.rb"
-
-class CodegenTests < Test::Unit::TestCase
-    :third_party_provider_header
-    :third_party_provider_implementation
-    :base_path
-    :prefix
-    :tmp_schema_list_file
-
-    def setup
-        Pod::Config.reset()
-
-        @prefix = "../.."
-        @third_party_provider_header = "RCTThirdPartyFabricComponentsProvider.h"
-        @third_party_provider_implementation = "RCTThirdPartyFabricComponentsProvider.mm"
-        @base_path = "~/app/ios"
-        @tmp_schema_list_file = "tmpSchemaList.txt"
-        Pathname.pwd!(@base_path)
-        Pod::Config.instance.installation_root.relative_path_from = @base_path
-    end
-
-    def teardown
-        system_reset_commands()
-        Pod::UI.reset()
-        Pod::Executable.reset()
-        Pathname.reset()
-        FileMock.reset()
-        DirMock.reset()
-    end
-
-    # ============================================== #
-    # Test - setup_fabric #
-    # ============================================== #
-    def testCheckAndGenerateEmptyThirdPartyProvider_whenFileAlreadyExists_doNothing()
-
-        # Arrange
-        FileMock.mocked_existing_files([
-            @prefix + "/React/Fabric/" + @third_party_provider_header,
-            @prefix + "/React/Fabric/" + @third_party_provider_implementation,
-        ])
-
-        # Act
-        checkAndGenerateEmptyThirdPartyProvider!(@prefix, false, dir_manager: DirMock, file_manager: FileMock)
-
-        # Assert
-        assert_equal(Pathname.pwd_invocation_count, 1)
-        assert_equal(Pod::Config.instance.installation_root.relative_path_from_invocation_count, 1)
-        assert_equal(FileMock.exist_invocation_params, [
-            @prefix + "/React/Fabric/" + @third_party_provider_header,
-            @prefix + "/React/Fabric/" + @third_party_provider_implementation,
-        ])
-        assert_equal(DirMock.exist_invocation_params, [])
-        assert_equal(Pod::UI.collected_messages, [])
-        assert_equal($collected_commands, [])
-        assert_equal(FileMock.open_files.length, 0)
-        assert_equal(Pod::Executable.executed_commands.length, 0)
-    end
-
-    def testCheckAndGenerateEmptyThirdPartyProvider_whenHeaderMissingAndCodegenMissing_raiseError()
-
-        # Arrange
-        FileMock.mocked_existing_files([
-            @base_path + "/build/" + @third_party_provider_implementation,
-        ])
-
-        # Act
-        assert_raise {
-            checkAndGenerateEmptyThirdPartyProvider!(@prefix, false, dir_manager: DirMock, file_manager: FileMock)
-        }
-
-        # Assert
-        assert_equal(Pathname.pwd_invocation_count, 1)
-        assert_equal(Pod::Config.instance.installation_root.relative_path_from_invocation_count, 1)
-        assert_equal(FileMock.exist_invocation_params, [
-            @prefix + "/React/Fabric/" + @third_party_provider_header
-        ])
-        assert_equal(DirMock.exist_invocation_params, [
-            @base_path + "/"+ @prefix + "/../react-native-codegen",
-            @base_path + "/"+ @prefix + "/../@react-native/codegen",
-        ])
-        assert_equal(Pod::UI.collected_messages, [])
-        assert_equal($collected_commands, [])
-        assert_equal(FileMock.open_files.length, 0)
-        assert_equal(Pod::Executable.executed_commands.length, 0)
-    end
-
-    def testCheckAndGenerateEmptyThirdPartyProvider_whenImplementationMissingAndCodegenrepoExists_dontBuildCodegen()
-
-        # Arrange
-        FileMock.mocked_existing_files([
-            @prefix + "/React/Fabric/" + @third_party_provider_header,
-            @prefix + "/React/Fabric/tmpSchemaList.txt"
-        ])
-
-        DirMock.mocked_existing_dirs([
-            @base_path + "/"+ @prefix + "/../react-native-codegen",
-            @base_path + "/"+ @prefix + "/../react-native-codegen/lib"
-        ])
-
-        # Act
-        checkAndGenerateEmptyThirdPartyProvider!(@prefix, false, dir_manager: DirMock, file_manager: FileMock)
-
-        # Assert
-        assert_equal(Pathname.pwd_invocation_count, 1)
-        assert_equal(Pod::Config.instance.installation_root.relative_path_from_invocation_count, 1)
-        assert_equal(FileMock.exist_invocation_params, [
-            @prefix + "/React/Fabric/" + @third_party_provider_header,
-            @prefix + "/React/Fabric/" + @third_party_provider_implementation,
-            @prefix + "/React/Fabric/tmpSchemaList.txt",
-        ])
-        assert_equal(DirMock.exist_invocation_params, [
-            @base_path + "/"+ @prefix + "/../react-native-codegen",
-            @base_path + "/"+ @prefix + "/../react-native-codegen/lib",
-        ])
-        assert_equal(Pod::UI.collected_messages, ["[Codegen] generating an empty RCTThirdPartyFabricComponentsProvider"])
-        assert_equal($collected_commands, [])
-        assert_equal(FileMock.open_invocation_count, 1)
-        assert_equal(FileMock.open_files_with_mode[@prefix + "/React/Fabric/tmpSchemaList.txt"], 'w')
-        assert_equal(FileMock.open_files[0].collected_write, ["[]"])
-        assert_equal(FileMock.open_files[0].fsync_invocation_count, 1)
-        assert_equal(Pod::Executable.executed_commands[0], {
-            "command" => "node",
-            "arguments" => [
-                @base_path + "/" + @prefix + "/scripts/generate-provider-cli.js",
-                "--platform", 'ios',
-                "--schemaListPath", @prefix + "/React/Fabric/tmpSchemaList.txt",
-                "--outputDir", @prefix + "/React/Fabric"
-            ]
-        })
-        assert_equal(FileMock.delete_invocation_count, 1)
-        assert_equal(FileMock.deleted_files, [ @prefix + "/React/Fabric/tmpSchemaList.txt"])
-    end
-
-    def testCheckAndGenerateEmptyThirdPartyProvider_whenBothMissing_buildCodegen()
-        # Arrange
-        codegen_cli_path = @base_path + "/" + @prefix + "/../@react-native/codegen"
-        DirMock.mocked_existing_dirs([
-            codegen_cli_path,
-        ])
-        # Act
-        checkAndGenerateEmptyThirdPartyProvider!(@prefix, false, dir_manager: DirMock, file_manager: FileMock)
-
-        # Assert
-        assert_equal(Pathname.pwd_invocation_count, 1)
-        assert_equal(Pod::Config.instance.installation_root.relative_path_from_invocation_count, 1)
-        assert_equal(FileMock.exist_invocation_params, [
-            @prefix + "/React/Fabric/" + @third_party_provider_header,
-            @prefix + "/React/Fabric/" + @tmp_schema_list_file
-        ])
-        assert_equal(DirMock.exist_invocation_params, [
-            @base_path + "/" + @prefix + "/../react-native-codegen",
-            codegen_cli_path,
-            codegen_cli_path + "/lib",
-        ])
-        assert_equal(Pod::UI.collected_messages, [
-            "[Codegen] building #{codegen_cli_path}.",
-            "[Codegen] generating an empty RCTThirdPartyFabricComponentsProvider"
-        ])
-        assert_equal($collected_commands, ["~/app/ios/../../../@react-native/codegen/scripts/oss/build.sh"])
-        assert_equal(FileMock.open_files[0].collected_write, ["[]"])
-        assert_equal(FileMock.open_files[0].fsync_invocation_count, 1)
-        assert_equal(Pod::Executable.executed_commands[0], {
-            "command" => "node",
-            "arguments" => [
-                @base_path + "/" + @prefix + "/scripts/generate-provider-cli.js",
-                "--platform", 'ios',
-                "--schemaListPath", @prefix + "/React/Fabric/" + @tmp_schema_list_file,
-                "--outputDir", @prefix + "/React/Fabric"
-            ]
-        })
-    end
-
-    # ================= #
-    # Test - RunCodegen #
-    # ================= #
-    def testRunCodegen_whenNewArchEnabled_runsCodegen
-        # Arrange
-        app_path = "~/app"
-        config_file = ""
-        codegen_utils_mock = CodegenUtilsMock.new()
-
-        # Act
-        run_codegen!(app_path, config_file, :new_arch_enabled => true, :codegen_utils => codegen_utils_mock)
-
-        # Assert
-        assert_equal(codegen_utils_mock.use_react_native_codegen_discovery_params, [{
-            :app_path=>"~/app",
-            :codegen_disabled=>false,
-            :codegen_output_dir=>"build/generated/ios",
-            :config_file_dir=>"",
-            :fabric_enabled=>false,
-            :folly_version=>"2021.07.22.00",
-            :react_native_path=>"../node_modules/react-native"
-        }])
-        assert_equal(codegen_utils_mock.get_react_codegen_spec_params, [])
-        assert_equal(codegen_utils_mock.generate_react_codegen_spec_params, [])
-    end
-
-    def testRunCodegen_whenNewArchDisabled_runsCodegen
-        # Arrange
-        app_path = "~/app"
-        config_file = ""
-        package_json_file = "~/app/package.json"
-        codegen_specs = { "name" => "React-Codegen" }
-        codegen_utils_mock = CodegenUtilsMock.new(:react_codegen_spec => codegen_specs)
-
-        # Act
-        run_codegen!(
-            app_path,
-            config_file,
-            :new_arch_enabled => false,
-            :fabric_enabled => true,
-            :package_json_file => package_json_file,
-            :codegen_utils => codegen_utils_mock)
-
-        # Assert
-        assert_equal(codegen_utils_mock.use_react_native_codegen_discovery_params, [])
-        assert_equal(codegen_utils_mock.get_react_codegen_spec_params, [{
-            :fabric_enabled => true,
-            :folly_version=>"2021.07.22.00",
-            :package_json_file => "~/app/package.json",
-            :script_phases => nil
-        }])
-        assert_equal(codegen_utils_mock.generate_react_codegen_spec_params, [{
-            :codegen_output_dir=>"build/generated/ios",
-            :react_codegen_spec=>{"name"=>"React-Codegen"}
-        }])
-
-    end
-end