/*
 * 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.touch

import android.view.ViewGroup

/**
 * This interface should be implemented by all [ViewGroup] subviews that can be instantiating by
 * [com.facebook.react.uimanager.NativeViewHierarchyManager]. It is used to configure
 * onInterceptTouch event listener which then is used to control touch event flow in cases in which
 * they requested to be intercepted by some parent view based on a JS gesture detector.
 */
internal interface ReactInterceptingViewGroup {

  /**
   * A [ViewGroup] instance that implement this interface is responsible for storing the listener
   * passed as an argument and then calling [OnInterceptTouchEventListener#onInterceptTouchEvent]
   * from [ViewGroup#onInterceptTouchEvent] and returning the result. If some custom handling of
   * this method apply for the view, it should be called after the listener returns and only in a
   * case when it returns false.
   *
   * @param listener A callback that [ViewGroup] should delegate calls for
   *   [ViewGroup#onInterceptTouchEvent] to
   */
  fun setOnInterceptTouchEventListener(listener: OnInterceptTouchEventListener)
}