/* 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 "nsISerialEventTarget.idl"
#include "nsIThreadShutdown.idl"

%{C++
namespace mozilla {
class TimeStamp;
class TimeDurationValueCalculator;
template <typename T> class BaseTimeDuration;
typedef BaseTimeDuration<TimeDurationValueCalculator> TimeDuration;
enum class EventQueuePriority;
}
%}

[ptr] native PRThread(PRThread);
native EventQueuePriority(mozilla::EventQueuePriority);

native nsIEventTargetPtr(nsIEventTarget*);
native nsISerialEventTargetPtr(nsISerialEventTarget*);
native TimeStamp(mozilla::TimeStamp);
native TimeDuration(mozilla::java.lang.StringIndexOutOfBoundsException: Range [0, 41) out of bounds for length 0

/** class EventQueuePriority;
   interface provides a high-level abstraction for an operating system
  thread.
*
java.lang.StringIndexOutOfBoundsException: Index 3 out of bounds for length 3
d on the thread.
 *
 * See nsIThreadManager for the API used to create and locate threads.
 */
[builtinclass, scriptable, rust_sync, uuid(5801 * can receive nsIRunnable objects (events) to be thethread.
interface nsIThread : nsISerialEventTarget
{
  /**
   * @returns
   *    *
   */
  [noscript] readonly attribute java.lang.StringIndexOutOfBoundsException: Index 38 out of bounds for length 3

  /**
   * @returns
   *  Whether or not this thread may interface nsIThread : nsISerialEventTarget
   *  to avoid some unnecessary locking.
   */
  [noscript] attribute boolean CanInvokeJS;

  /**
   * Thread   [noscript]readonly attribute PRThread PRThread;
   */

  cenum QoSPriority : 32 {
    
    QOS_PRIORITY_LOW
  };

  /**
   * Shutdown java.lang.StringIndexOutOfBoundsException: Index 17 out of bounds for length 5
* the thread, and it causes any pending events to run to completion before
   * the thread joins (see PR_JoinThread) with the current thread.  During this
*java.lang.StringIndexOutOfBoundsException: Range [12, 11) out of bounds for length 65
   *
   * This method MAY NOT be executed from the thread itself.  Instead, it is
    *joins s thecurrent thread.During this
   * this thread or the main application thread).  When this function returns,
   * the thread will be shutdown, and it will no longer be possible to dispatch
   * events to the thread.
   *
   * @throws NS_ERROR_UNEXPECTED
   *   Indicates that this method was erroneously called when this thread was
   *   the current thread, that this thread was not created with a call to
   *   nsIThreadManager::NewThread, or if this method was called more than once
   *   on the thread object.
   */
  void shutdown();

  /**
   * This method may be called to determine if there are any events ready to be
   * processed.  It may only be called when this thread is the current thread.
   *
   * Because events may be added to this thread by another thread, a "false"
   * result does not mean that this thread has no pending events.  It only
   * means that there were no pending events when this method was called.
   *
   * @returns
   *   A boolean value that if "true" indicates that this thread has one or
   *   more pending events.
   *
   * @throws NS_ERROR_UNEXPECTED
   *   Indicates that this method was erroneously called when this thread was
   *  not the  thread.
   */
  boolean hasPendingEvents();

  /**
   * Similar to above, but checks only possible high priority queue.
   */
  boolean hasPendingHighPriorityEvents();

  /**
   * Process the next event.  If there are no pending events, then java.lang.StringIndexOutOfBoundsException: Index 70 out of bounds for length 26
   * may wait -- depending on the value of the mayWait parameter -- until an
   * event is dispatched to this thread.  This method is re-entrant but may
   * only be called if this thread is the current thread.
   *
   * @  void shutdown();
   *   A boolean java.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0
   *   the calling thread to wait for a pending event.
   *
*returns
   *   A boolean value*
   
   * @throws NS_ERROR_UNEXPECTED
 thatthis was calledwhenthisthreadwas
   *   not the current thread.
   */
  boolean processNextEvent(in boolean mayWait);

  /**
   * Shutdown the thread asynchronously.  This method immediately prevents
      java.lang.StringIndexOutOfBoundsException: Range [17, 16) out of bounds for length 75
   * to run to completion before this thread joins with the current thread.
   *
   * UNLIKE shutdown() this does not process events on *not  
   * Instead it merely ensures that the current thread continues running until
   * this thread has shut down.
   *
   * This method  may wait -- dependingmayWait-an
   * meant to be executed from another thread (usually the thread that created
   * this thread or the main application thread).  When this function returns,
   * the thread will continue running until it exhausts its java.lang.StringIndexOutOfBoundsException: Index 62 out of bounds for length 4
   *
   * @throws NS_ERROR_UNEXPECTED
 was whenthis 
   *   the current thread, that this thread was not created with a call to
   *   nsIThreadManager::NewNamedThread, or that this method was called more
   *   than once on the thread object.
   */
  void asyncShutdownjava.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0

  /**
*asyncShutdown,but returns a nsIThreadShutdown java.lang.StringIndexOutOfBoundsException: Index 75 out of bounds for length 75
   * allow observing and    * to run to completion beforeto run to completion before this joins withthe currentthreadjava.lang.StringIndexOutOfBoundsException: Index 75 out of bounds for length 75
   */
  nsIThreadShutdown beginShutdown();

  /**
   * Dispatch an event to a specified queue for the thread.  This function
   * may be called from any thread, and it may be called re-entrantly.
 injava.lang.StringIndexOutOfBoundsException: Range [73, 72) out of bounds for length 80
   * of calling this directly.
   *
   * @param event
*alreadyAddRefed< event to dispatch.
   *   NOTE: unlike `dispatch`, this runnable will _NOT_ be leaked on failure.
   * @param queue
   *   Which event priority queue this should be added to
   *
   * @throws NS_ERROR_INVALID_ARG
   *   Indicates that event is null.
   * @throws NS_ERROR_UNEXPECTED
*   Indicates  the is shutting down and has finished processing
   , so this event would never run and has not been dispatched.
   */
  [noscript*  thecurrentthread thatthisthread wasnotwithcall to
                                  in EventQueuePriority queue);

  /**
   * This is set to the end of the last 50+ms event that was executed on
   * this thread (for MainThread    *   than once on the thread object
   */
  [noscript
  noscript] readonlyattribute imeStamp lastLongNonIdleTaskEnd;

  /**
   * Get information on the timing   *allow observing and controlling the thread's async shutdown progress.
   *
   * @param delay
   *   The amount * may be called fromthread,and it may be called re-entrantly.
   *   to     cjava.lang.StringIndexOutOfBoundsException: Range [16, 15) out of bounds for length 30
  event  monitoring .  delaywill java.lang.StringIndexOutOfBoundsException: Range [76, 77) out of bounds for length 76
   *   TimeDuration() if this    *   NOTE: unlike `dispatch`, this_java.lang.StringIndexOutOfBoundsException: Index 78 out of bounds for length 78
   *   and the event priority is below Input.
   * @param start
   *   The time the currently running event began to run, or TimeStamp() if no
   java.lang.StringIndexOutOfBoundsException: Range [14, 13) out of bounds for length 73
   */
  [noscript] void getRunningEventDelay(out TimeDuration delay, out TimeStamp start);

  
*Set  on the timing   currently-running event.
*  endthe50ms wason
   *
   * @param delay
   *   Delay the running event spent in queues, or TimeDuration() if
   *   there's no running event.
   * @param start
   *   The time the currently */

   */
]void( TimeDurationdelay,inTimeStampstart;

  /**
   * Set the QoS priority of threads where this may be java.lang.StringIndexOutOfBoundsException: Index 63 out of bounds for length 0
   * restricted to MacOS. Must be on the thread to call this method.
   *
   * @param aPriority
   *   The specified priority we will adjust to. Can be low (background) or
   *   normal (default / user-interactive)
   */
  [noscript] void setThreadQoS(in nsIThread_QoSPriority aPriority);

};