/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#include "nsISupports.idl"

interface nsIAutoCompletePopup;
interface nsIAutoCompleteResult;

webidl Document;
webidl Element;
webidl Event;

[scriptable, uuid(644ac1f4-2122-498e-87bf-2b01d2e24c1e)]
interface nsIFormFillFocusListener : nsISupports {
  /*
   * Called when a form field is focused and may be used to delay showing
   * autocomplete UI until the operation is complete.
   *
   * @param element the element that is focused.
   */
  Promise handleFocus(in Element element);
};

/*
 * nsIFormFillController is an interface for controlling form fill behavior
 * on HTML documents.  Any number of docShells can be controller concurrently.
 * While a docShell is attached, all HTML documents that are loaded within it
 * will have a focus listener attached that will listen for when a text input
 * is focused.  When this happens, the input will be bound to the
 * global nsIAutoCompleteController service.
 */

[scriptable, uuid(07f0a0dc-f6e9-4cdd-a55f-56d770523a4c)]
interface nsIFormFillController : nsISupports
{
  /*
   * The input or textarea element the form fill controller is currently bound to.
   */
  [setter_can_run_script] attribute Element controlledElement;

  /*
   * Whether the autocomplete popup on a password field was automatically opened
   * by the form fill controller (upon focus).
   */
  readonly attribute boolean passwordPopupAutomaticallyOpened;

  /*
   * Mark the specified <input> element as being managed by autocomplete entry provider.
   * Autocomplete requests will be handed off to the AutoCompleteChild.
   *
   * @param aElement - The HTML <input> or <textarea> element to mark
   */
  [can_run_script] void markAsAutoCompletableField(in Element aElement);

  /*
   * Open the autocomplete popup, if possible.
   */
  [can_run_script] void showPopup();

  /*
   * Add a listener which will be notified when a field is focused.
   *
   * @param listener the listener to be notified.
   */
  void addFocusListener(in nsIFormFillFocusListener listener);
};

[scriptable, function, uuid(604419ab-55a0-4831-9eca-1b9e67cc4751)]
interface nsIFormFillCompleteObserver : nsISupports
{
  /*
   * Called when a search is complete and the results are ready even if the
   * result set is empty. If the search is cancelled or a new search is
   * started, this is not called.
   *
   * @param result - The search result object
   */
  [can_run_script] void onSearchCompletion(in nsIAutoCompleteResult result);
};