// Create a suggestion popup containing a recycler view
Suggestive.recycler(

    // anchor to queryEditText
    queryEditText,
    
    // use the recycler view adapter
    adapter,
    
    // only invoke onQuery at a minimum input of 3 characters
    minCharacters = 3,
            
    // attaches the text change listener that invokes [onQuery]
    attachTextChangeListener = true,
    
    // invoke onQuery with a minimum delay of 200 ms
    onQueryThrottle = 200,
    
    // align the popup to the start of the anchor view
    gravity = Gravity.START,
    
    // use the background drawable for the popup window background
    backgroundDrawable = ContextCompat.getDrawable(this, R.drawable.popup_rounded_bg)!!,
    
    // constrains the popup windows width to the width of anchor
    constrainWidthToAnchorBounds = true,
    
    // hide the popup window when anchor loses focus
    hideOnBlur = true,
    
    // show the popup above or below anchor based on available space around anchor
    preferredPosition = SuggestionWindow.PreferredPosition.BEST_FIT,
    
    // dismisses the popup when the back button is pressed
    dismissOnBackPress = true,
    
    // the input query callback, called for every text change event on anchor
    //  (with exclusions as mandated by the minCharacters and onQueryThrottle options)
    onQuery = { query ->
    vm.search(query)
})

val view: View = //...
Suggestive.view(anchorView, view)

val popup = Suggestive.view(anchorView, view)
popup.show() // popup.isHidden = true
popup.hide() // popup.isHidden = false
popup.requestLayout() // relayout the popup content view