package Torello.Browser;

import java.util.*;
import javax.json.*;
import javax.json.stream.*;
import java.io.*;

import java.lang.reflect.Method;
import java.lang.reflect.Parameter;
import java.util.function.Function;

import Torello.Java.Additional.*;
import Torello.Java.JSON.*;

import static Torello.Java.JSON.JFlag.*;

import Torello.Java.StrCmpr;
import Torello.JavaDoc.StaticFunctional;
import Torello.JavaDoc.JDHeaderBackgroundImg;
import Torello.JavaDoc.Excuse;

/**
 * <SPAN CLASS=COPIEDJDK><B><CODE>[No Description Provided by Google]</CODE></B></SPAN>
 * 
 * <EMBED CLASS='external-html' DATA-FILE-ID=CODE_GEN_NOTE>
 */
@StaticFunctional(Excused={"counter"}, Excuses={Excuse.CONFIGURATION})
@JDHeaderBackgroundImg(EmbedTagFileID="WOOD_PLANK_NOTE")
public class Input
{
    // ********************************************************************************************
    // ********************************************************************************************
    // Class Header Stuff
    // ********************************************************************************************
    // ********************************************************************************************


    // No Pubic Constructors
    private Input () { }

    // These two Vector's are used by all the "Methods" exported by this class.  java.lang.reflect
    // is used to generate the JSON String's.  It saves thousands of lines of Auto-Generated Code.
    private static final Map<String, Vector<String>>    parameterNames = new HashMap<>();
    private static final Map<String, Vector<Class<?>>>  parameterTypes = new HashMap<>();

    // Some Methods do not take any parameters - for instance all the "enable()" and "disable()"
    // I simply could not get ride of RAW-TYPES and UNCHECKED warnings... so there are now,
    // offically, two empty-vectors.  One for String's, and the other for Classes.

    private static final Vector<String>     EMPTY_VEC_STR = new Vector<>();
    private static final Vector<Class<?>>   EMPTY_VEC_CLASS = new Vector<>();

    static
    {
        for (Method m : Input.class.getMethods())
        {
            // This doesn't work!  The parameter names are all "arg0" ... "argN"
            // It works for java.lang.reflect.Field, BUT NOT java.lang.reflect.Parameter!
            //
            // Vector<String> parameterNamesList = new Vector<>(); -- NOPE!

            Vector<Class<?>> parameterTypesList = new Vector<>();
        
            for (Parameter p : m.getParameters()) parameterTypesList.add(p.getType());

            parameterTypes.put(
                m.getName(),
                (parameterTypesList.size() > 0) ? parameterTypesList : EMPTY_VEC_CLASS
            );
        }
    }

    static
    {
        Vector<String> v = null;

        v = new Vector<String>(5);
        parameterNames.put("dispatchDragEvent", v);
        Collections.addAll(v, new String[]
        { "type", "x", "y", "data", "modifiers", });

        v = new Vector<String>(15);
        parameterNames.put("dispatchKeyEvent", v);
        Collections.addAll(v, new String[]
        { "type", "modifiers", "timestamp", "text", "unmodifiedText", "keyIdentifier", "code", "key", "windowsVirtualKeyCode", "nativeVirtualKeyCode", "autoRepeat", "isKeypad", "isSystemKey", "location", "commands", });

        v = new Vector<String>(1);
        parameterNames.put("insertText", v);
        Collections.addAll(v, new String[]
        { "text", });

        v = new Vector<String>(5);
        parameterNames.put("imeSetComposition", v);
        Collections.addAll(v, new String[]
        { "text", "selectionStart", "selectionEnd", "replacementStart", "replacementEnd", });

        v = new Vector<String>(16);
        parameterNames.put("dispatchMouseEvent", v);
        Collections.addAll(v, new String[]
        { "type", "x", "y", "modifiers", "timestamp", "button", "buttons", "clickCount", "force", "tangentialPressure", "tiltX", "tiltY", "twist", "deltaX", "deltaY", "pointerType", });

        v = new Vector<String>(4);
        parameterNames.put("dispatchTouchEvent", v);
        Collections.addAll(v, new String[]
        { "type", "touchPoints", "modifiers", "timestamp", });

        v = new Vector<String>(9);
        parameterNames.put("emulateTouchFromMouseEvent", v);
        Collections.addAll(v, new String[]
        { "type", "x", "y", "button", "timestamp", "deltaX", "deltaY", "modifiers", "clickCount", });

        v = new Vector<String>(1);
        parameterNames.put("setIgnoreInputEvents", v);
        Collections.addAll(v, new String[]
        { "ignore", });

        v = new Vector<String>(1);
        parameterNames.put("setInterceptDrags", v);
        Collections.addAll(v, new String[]
        { "enabled", });

        v = new Vector<String>(5);
        parameterNames.put("synthesizePinchGesture", v);
        Collections.addAll(v, new String[]
        { "x", "y", "scaleFactor", "relativeSpeed", "gestureSourceType", });

        v = new Vector<String>(12);
        parameterNames.put("synthesizeScrollGesture", v);
        Collections.addAll(v, new String[]
        { "x", "y", "xDistance", "yDistance", "xOverscroll", "yOverscroll", "preventFling", "speed", "gestureSourceType", "repeatCount", "repeatDelayMs", "interactionMarkerName", });

        v = new Vector<String>(5);
        parameterNames.put("synthesizeTapGesture", v);
        Collections.addAll(v, new String[]
        { "x", "y", "duration", "tapCount", "gestureSourceType", });
    }


    // ********************************************************************************************
    // ********************************************************************************************
    // Types - Static Inner Classes
    // ********************************************************************************************
    // ********************************************************************************************

    // public static class TimeSinceEpoch => Number
    
    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * <BR />
     * <BR /><B>EXPERIMENTAL</B>
     */
    public static final String[] GestureSourceType =
    { "default", "touch", "mouse", };
    
    /** <CODE>[No Description Provided by Google]</CODE> */
    public static final String[] MouseButton =
    { "none", "left", "middle", "right", "back", "forward", };
    
    /** <CODE>[No Description Provided by Google]</CODE> */
    public static class TouchPoint
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, true, true, true, true, true, true, true, true, true, }; }
        
        /** X coordinate of the event relative to the main frame's viewport in CSS pixels. */
        public final Number x;
        
        /**
         * Y coordinate of the event relative to the main frame's viewport in CSS pixels. 0 refers to
         * the top of the viewport and Y increases as it proceeds towards the bottom of the viewport.
         */
        public final Number y;
        
        /**
         * X radius of the touch area (default: 1.0).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Number radiusX;
        
        /**
         * Y radius of the touch area (default: 1.0).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Number radiusY;
        
        /**
         * Rotation angle (default: 0.0).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Number rotationAngle;
        
        /**
         * Force (default: 1.0).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Number force;
        
        /**
         * The normalized tangential pressure, which has a range of [-1,1] (default: 0).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         */
        public final Number tangentialPressure;
        
        /**
         * The plane angle between the Y-Z plane and the plane containing both the stylus axis and the Y axis, in degrees of the range [-90,90], a positive tiltX is to the right (default: 0)
         * <BR />
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         */
        public final Integer tiltX;
        
        /**
         * The plane angle between the X-Z plane and the plane containing both the stylus axis and the X axis, in degrees of the range [-90,90], a positive tiltY is towards the user (default: 0).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         */
        public final Integer tiltY;
        
        /**
         * The clockwise rotation of a pen stylus around its own major axis, in degrees in the range [0,359] (default: 0).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         */
        public final Integer twist;
        
        /**
         * Identifier used to track touch sources between events, must be unique within an event.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Number id;
        
        /**
         * Constructor
         *
         * @param x X coordinate of the event relative to the main frame's viewport in CSS pixels.
         * 
         * @param y 
         * Y coordinate of the event relative to the main frame's viewport in CSS pixels. 0 refers to
         * the top of the viewport and Y increases as it proceeds towards the bottom of the viewport.
         * 
         * @param radiusX X radius of the touch area (default: 1.0).
         * <BR /><B>OPTIONAL</B>
         * 
         * @param radiusY Y radius of the touch area (default: 1.0).
         * <BR /><B>OPTIONAL</B>
         * 
         * @param rotationAngle Rotation angle (default: 0.0).
         * <BR /><B>OPTIONAL</B>
         * 
         * @param force Force (default: 1.0).
         * <BR /><B>OPTIONAL</B>
         * 
         * @param tangentialPressure The normalized tangential pressure, which has a range of [-1,1] (default: 0).
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         * 
         * @param tiltX The plane angle between the Y-Z plane and the plane containing both the stylus axis and the Y axis, in degrees of the range [-90,90], a positive tiltX is to the right (default: 0)
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         * 
         * @param tiltY The plane angle between the X-Z plane and the plane containing both the stylus axis and the X axis, in degrees of the range [-90,90], a positive tiltY is towards the user (default: 0).
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         * 
         * @param twist The clockwise rotation of a pen stylus around its own major axis, in degrees in the range [0,359] (default: 0).
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         * 
         * @param id Identifier used to track touch sources between events, must be unique within an event.
         * <BR /><B>OPTIONAL</B>
         */
        public TouchPoint(
                Number x, Number y, Number radiusX, Number radiusY, Number rotationAngle, 
                Number force, Number tangentialPressure, Integer tiltX, Integer tiltY, 
                Integer twist, Number id
            )
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (x == null) BRDPC.throwNPE("x");
            if (y == null) BRDPC.throwNPE("y");
            
            this.x                   = x;
            this.y                   = y;
            this.radiusX             = radiusX;
            this.radiusY             = radiusY;
            this.rotationAngle       = rotationAngle;
            this.force               = force;
            this.tangentialPressure  = tangentialPressure;
            this.tiltX               = tiltX;
            this.tiltY               = tiltY;
            this.twist               = twist;
            this.id                  = id;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'TouchPoint'}.
         */
        public TouchPoint (JsonObject jo)
        {
            this.x                   = ReadNumberJSON.get(jo, "x", false, true);
            this.y                   = ReadNumberJSON.get(jo, "y", false, true);
            this.radiusX             = ReadNumberJSON.get(jo, "radiusX", true, false);
            this.radiusY             = ReadNumberJSON.get(jo, "radiusY", true, false);
            this.rotationAngle       = ReadNumberJSON.get(jo, "rotationAngle", true, false);
            this.force               = ReadNumberJSON.get(jo, "force", true, false);
            this.tangentialPressure  = ReadNumberJSON.get(jo, "tangentialPressure", true, false);
            this.tiltX               = ReadBoxedJSON.getInteger(jo, "tiltX", true);
            this.tiltY               = ReadBoxedJSON.getInteger(jo, "tiltY", true);
            this.twist               = ReadBoxedJSON.getInteger(jo, "twist", true);
            this.id                  = ReadNumberJSON.get(jo, "id", true, false);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            TouchPoint o = (TouchPoint) other;
        
            return
                    Objects.equals(this.x, o.x)
                &&  Objects.equals(this.y, o.y)
                &&  Objects.equals(this.radiusX, o.radiusX)
                &&  Objects.equals(this.radiusY, o.radiusY)
                &&  Objects.equals(this.rotationAngle, o.rotationAngle)
                &&  Objects.equals(this.force, o.force)
                &&  Objects.equals(this.tangentialPressure, o.tangentialPressure)
                &&  Objects.equals(this.tiltX, o.tiltX)
                &&  Objects.equals(this.tiltY, o.tiltY)
                &&  Objects.equals(this.twist, o.twist)
                &&  Objects.equals(this.id, o.id);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.x)
                +   Objects.hashCode(this.y)
                +   Objects.hashCode(this.radiusX)
                +   Objects.hashCode(this.radiusY)
                +   Objects.hashCode(this.rotationAngle)
                +   Objects.hashCode(this.force)
                +   Objects.hashCode(this.tangentialPressure)
                +   Objects.hashCode(this.tiltX)
                +   Objects.hashCode(this.tiltY)
                +   Objects.hashCode(this.twist)
                +   Objects.hashCode(this.id);
        }
    }
    
    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * <BR />
     * <BR /><B>EXPERIMENTAL</B>
     */
    public static class DragDataItem
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, true, true, }; }
        
        /** Mime type of the dragged data. */
        public final String mimeType;
        
        /**
         * Depending of the value of <CODE>mimeType</CODE>, it contains the dragged link,
         * text, HTML markup or any other data.
         */
        public final String data;
        
        /**
         * Title associated with a link. Only valid when <CODE>mimeType</CODE> == "text/uri-list".
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String title;
        
        /**
         * Stores the base URL for the contained markup. Only valid when <CODE>mimeType</CODE>
         * == "text/html".
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String baseURL;
        
        /**
         * Constructor
         *
         * @param mimeType Mime type of the dragged data.
         * 
         * @param data 
         * Depending of the value of <CODE>mimeType</CODE>, it contains the dragged link,
         * text, HTML markup or any other data.
         * 
         * @param title Title associated with a link. Only valid when <CODE>mimeType</CODE> == "text/uri-list".
         * <BR /><B>OPTIONAL</B>
         * 
         * @param baseURL 
         * Stores the base URL for the contained markup. Only valid when <CODE>mimeType</CODE>
         * == "text/html".
         * <BR /><B>OPTIONAL</B>
         */
        public DragDataItem(String mimeType, String data, String title, String baseURL)
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (mimeType == null) BRDPC.throwNPE("mimeType");
            if (data == null)     BRDPC.throwNPE("data");
            
            this.mimeType  = mimeType;
            this.data      = data;
            this.title     = title;
            this.baseURL   = baseURL;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'DragDataItem'}.
         */
        public DragDataItem (JsonObject jo)
        {
            this.mimeType  = ReadJSON.getString(jo, "mimeType", false, true);
            this.data      = ReadJSON.getString(jo, "data", false, true);
            this.title     = ReadJSON.getString(jo, "title", true, false);
            this.baseURL   = ReadJSON.getString(jo, "baseURL", true, false);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            DragDataItem o = (DragDataItem) other;
        
            return
                    Objects.equals(this.mimeType, o.mimeType)
                &&  Objects.equals(this.data, o.data)
                &&  Objects.equals(this.title, o.title)
                &&  Objects.equals(this.baseURL, o.baseURL);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.mimeType)
                +   Objects.hashCode(this.data)
                +   Objects.hashCode(this.title)
                +   Objects.hashCode(this.baseURL);
        }
    }
    
    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * <BR />
     * <BR /><B>EXPERIMENTAL</B>
     */
    public static class DragData
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, true, false, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final Input.DragDataItem[] items;
        
        /**
         * List of filenames that should be included when dropping
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String[] files;
        
        /** Bit field representing allowed drag operations. Copy = 1, Link = 2, Move = 16 */
        public final int dragOperationsMask;
        
        /**
         * Constructor
         *
         * @param items -
         * 
         * @param files List of filenames that should be included when dropping
         * <BR /><B>OPTIONAL</B>
         * 
         * @param dragOperationsMask Bit field representing allowed drag operations. Copy = 1, Link = 2, Move = 16
         */
        public DragData(Input.DragDataItem[] items, String[] files, int dragOperationsMask)
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (items == null) BRDPC.throwNPE("items");
            
            this.items               = items;
            this.files               = files;
            this.dragOperationsMask  = dragOperationsMask;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'DragData'}.
         */
        public DragData (JsonObject jo)
        {
            this.items = (jo.getJsonArray("items") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("items"), null, 0, Input.DragDataItem[].class);
        
            this.files = (jo.getJsonArray("files") == null)
                ? null
                : ReadArrJSON.DimN.strArr(jo.getJsonArray("files"), null, 0, String[].class);
        
            this.dragOperationsMask  = ReadPrimJSON.getInt(jo, "dragOperationsMask");
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            DragData o = (DragData) other;
        
            return
                    Arrays.deepEquals(this.items, o.items)
                &&  Arrays.deepEquals(this.files, o.files)
                &&  (this.dragOperationsMask == o.dragOperationsMask);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Arrays.deepHashCode(this.items)
                +   Arrays.deepHashCode(this.files)
                +   this.dragOperationsMask;
        }
    }
    
    /**
     * Emitted only when <CODE>Input.setInterceptDrags</CODE> is enabled. Use this data with <CODE>Input.dispatchDragEvent</CODE> to
     * restore normal drag and drop behavior.
     * <BR />
     * <BR /><B>EXPERIMENTAL</B>
     */
    public static class dragIntercepted
        extends BrowserEvent
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final Input.DragData data;
        
        /**
         * Constructor
         *
         * @param data -
         */
        public dragIntercepted(Input.DragData data)
        {
            super("Input", "dragIntercepted", 1);
            
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (data == null) BRDPC.throwNPE("data");
            
            this.data  = data;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'dragIntercepted'}.
         */
        public dragIntercepted (JsonObject jo)
        {
            super("Input", "dragIntercepted", 1);
        
            this.data  = ReadJSON.getObject(jo, "data", Input.DragData.class, false, true);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            dragIntercepted o = (dragIntercepted) other;
        
            return
                    Objects.equals(this.data, o.data);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.data.hashCode();
        }
    }
    
    
    // Counter for keeping the WebSocket Request ID's distinct.
    private static int counter = 1;
    
    /**
     * Dispatches a drag event into the page.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param type Type of the drag event.
     * <BR />Acceptable Values: ["dragEnter", "dragOver", "drop", "dragCancel"]
     * 
     * @param x X coordinate of the event relative to the main frame's viewport in CSS pixels.
     * 
     * @param y 
     * Y coordinate of the event relative to the main frame's viewport in CSS pixels. 0 refers to
     * the top of the viewport and Y increases as it proceeds towards the bottom of the viewport.
     * 
     * @param data -
     * 
     * @param modifiers 
     * Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8
     * (default: 0).
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> dispatchDragEvent
        (String type, Number x, Number y, Input.DragData data, Integer modifiers)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (type == null) BRDPC.throwNPE("type");
        if (x == null)    BRDPC.throwNPE("x");
        if (y == null)    BRDPC.throwNPE("y");
        if (data == null) BRDPC.throwNPE("data");
        
        // Exception-Check(s) to ensure that if any parameters which must adhere to a
        // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
        
        BRDPC.checkIAE(
            "type", type,
            "dragEnter", "dragOver", "drop", "dragCancel"
        );
        
        final int       webSocketID = 25000000 + counter++;
        final boolean[] optionals   = { false, false, false, false, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("dispatchDragEvent"),
            parameterNames.get("dispatchDragEvent"),
            optionals, webSocketID,
            "Input.dispatchDragEvent",
            type, x, y, data, modifiers
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Dispatches a key event to the page.
     * 
     * @param type Type of the key event.
     * <BR />Acceptable Values: ["keyDown", "keyUp", "rawKeyDown", "char"]
     * 
     * @param modifiers 
     * Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8
     * (default: 0).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param timestamp Time at which the event occurred.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param text 
     * Text as generated by processing a virtual key code with a keyboard layout. Not needed for
     * for <CODE>keyUp</CODE> and <CODE>rawKeyDown</CODE> events (default: "")
     * <BR /><B>OPTIONAL</B>
     * 
     * @param unmodifiedText 
     * Text that would have been generated by the keyboard if no modifiers were pressed (except for
     * shift). Useful for shortcut (accelerator) key handling (default: "").
     * <BR /><B>OPTIONAL</B>
     * 
     * @param keyIdentifier Unique key identifier (e.g., 'U+0041') (default: "").
     * <BR /><B>OPTIONAL</B>
     * 
     * @param code Unique DOM defined string value for each physical key (e.g., 'KeyA') (default: "").
     * <BR /><B>OPTIONAL</B>
     * 
     * @param key 
     * Unique DOM defined string value describing the meaning of the key in the context of active
     * modifiers, keyboard layout, etc (e.g., 'AltGr') (default: "").
     * <BR /><B>OPTIONAL</B>
     * 
     * @param windowsVirtualKeyCode Windows virtual key code (default: 0).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param nativeVirtualKeyCode Native virtual key code (default: 0).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param autoRepeat Whether the event was generated from auto repeat (default: false).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param isKeypad Whether the event was generated from the keypad (default: false).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param isSystemKey Whether the event was a system key event (default: false).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param location 
     * Whether the event was from the left or right side of the keyboard. 1=Left, 2=Right (default:
     * 0).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param commands 
     * Editing commands to send with the key event (e.g., 'selectAll') (default: []).
     * These are related to but not equal the command names used in <CODE>document.execCommand</CODE> and NSStandardKeyBindingResponding.
     * See https://source.chromium.org/chromium/chromium/src/+/master:third_party/blink/renderer/core/editing/commands/editor_command_names.h for valid command names.
     * <BR /><B>OPTIONAL</B>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> dispatchKeyEvent(
            String type, Integer modifiers, Number timestamp, String text, String unmodifiedText, 
            String keyIdentifier, String code, String key, Integer windowsVirtualKeyCode, 
            Integer nativeVirtualKeyCode, Boolean autoRepeat, Boolean isKeypad, Boolean isSystemKey, 
            Integer location, String[] commands
        )
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (type == null) BRDPC.throwNPE("type");
        
        // Exception-Check(s) to ensure that if any parameters which must adhere to a
        // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
        
        BRDPC.checkIAE(
            "type", type,
            "keyDown", "keyUp", "rawKeyDown", "char"
        );
        
        final int       webSocketID = 25001000 + counter++;
        final boolean[] optionals   = { false, true, true, true, true, true, true, true, true, true, true, true, true, true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("dispatchKeyEvent"),
            parameterNames.get("dispatchKeyEvent"),
            optionals, webSocketID,
            "Input.dispatchKeyEvent",
            type, modifiers, timestamp, text, unmodifiedText, keyIdentifier, code, key,
            windowsVirtualKeyCode, nativeVirtualKeyCode, autoRepeat, isKeypad, isSystemKey,
            location, commands
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * This method emulates inserting text that doesn't come from a key press,
     * for example an emoji keyboard or an IME.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param text The text to insert.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> insertText(String text)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (text == null) BRDPC.throwNPE("text");
        
        final int       webSocketID = 25002000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("insertText"),
            parameterNames.get("insertText"),
            optionals, webSocketID,
            "Input.insertText",
            text
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * This method sets the current candidate text for ime.
     * Use imeCommitComposition to commit the final text.
     * Use imeSetComposition with empty string as text to cancel composition.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param text The text to insert
     * 
     * @param selectionStart selection start
     * 
     * @param selectionEnd selection end
     * 
     * @param replacementStart replacement start
     * <BR /><B>OPTIONAL</B>
     * 
     * @param replacementEnd replacement end
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> imeSetComposition(
            String text, int selectionStart, int selectionEnd, Integer replacementStart, 
            Integer replacementEnd
        )
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (text == null) BRDPC.throwNPE("text");
        
        final int       webSocketID = 25003000 + counter++;
        final boolean[] optionals   = { false, false, false, true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("imeSetComposition"),
            parameterNames.get("imeSetComposition"),
            optionals, webSocketID,
            "Input.imeSetComposition",
            text, selectionStart, selectionEnd, replacementStart, replacementEnd
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Dispatches a mouse event to the page.
     * 
     * @param type Type of the mouse event.
     * <BR />Acceptable Values: ["mousePressed", "mouseReleased", "mouseMoved", "mouseWheel"]
     * 
     * @param x X coordinate of the event relative to the main frame's viewport in CSS pixels.
     * 
     * @param y 
     * Y coordinate of the event relative to the main frame's viewport in CSS pixels. 0 refers to
     * the top of the viewport and Y increases as it proceeds towards the bottom of the viewport.
     * 
     * @param modifiers 
     * Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8
     * (default: 0).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param timestamp Time at which the event occurred.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param button Mouse button (default: "none").
     * <BR /><B>OPTIONAL</B>
     * 
     * @param buttons 
     * A number indicating which buttons are pressed on the mouse when a mouse event is triggered.
     * Left=1, Right=2, Middle=4, Back=8, Forward=16, None=0.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param clickCount Number of times the mouse button was clicked (default: 0).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param force The normalized pressure, which has a range of [0,1] (default: 0).
     * <BR /><B>OPTIONAL</B>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param tangentialPressure The normalized tangential pressure, which has a range of [-1,1] (default: 0).
     * <BR /><B>OPTIONAL</B>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param tiltX The plane angle between the Y-Z plane and the plane containing both the stylus axis and the Y axis, in degrees of the range [-90,90], a positive tiltX is to the right (default: 0).
     * <BR /><B>OPTIONAL</B>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param tiltY The plane angle between the X-Z plane and the plane containing both the stylus axis and the X axis, in degrees of the range [-90,90], a positive tiltY is towards the user (default: 0).
     * <BR /><B>OPTIONAL</B>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param twist The clockwise rotation of a pen stylus around its own major axis, in degrees in the range [0,359] (default: 0).
     * <BR /><B>OPTIONAL</B>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param deltaX X delta in CSS pixels for mouse wheel event (default: 0).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param deltaY Y delta in CSS pixels for mouse wheel event (default: 0).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param pointerType Pointer type (default: "mouse").
     * <BR />Acceptable Values: ["mouse", "pen"]
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> dispatchMouseEvent(
            String type, Number x, Number y, Integer modifiers, Number timestamp, String button, 
            Integer buttons, Integer clickCount, Number force, Number tangentialPressure, 
            Integer tiltX, Integer tiltY, Integer twist, Number deltaX, Number deltaY, 
            String pointerType
        )
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (type == null) BRDPC.throwNPE("type");
        if (x == null)    BRDPC.throwNPE("x");
        if (y == null)    BRDPC.throwNPE("y");
        
        // Exception-Check(s) to ensure that if any parameters which must adhere to a
        // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
        
        BRDPC.checkIAE(
            "type", type,
            "mousePressed", "mouseReleased", "mouseMoved", "mouseWheel"
        );
        BRDPC.checkIAE("button", button, "Input.MouseButton", Input.MouseButton);
        BRDPC.checkIAE(
            "pointerType", pointerType,
            "mouse", "pen"
        );
        
        final int       webSocketID = 25004000 + counter++;
        final boolean[] optionals   = { false, false, false, true, true, true, true, true, true, true, true, true, true, true, true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("dispatchMouseEvent"),
            parameterNames.get("dispatchMouseEvent"),
            optionals, webSocketID,
            "Input.dispatchMouseEvent",
            type, x, y, modifiers, timestamp, button, buttons, clickCount, force,
            tangentialPressure, tiltX, tiltY, twist, deltaX, deltaY, pointerType
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Dispatches a touch event to the page.
     * 
     * @param type 
     * Type of the touch event. TouchEnd and TouchCancel must not contain any touch points, while
     * TouchStart and TouchMove must contains at least one.
     * <BR />Acceptable Values: ["touchStart", "touchEnd", "touchMove", "touchCancel"]
     * 
     * @param touchPoints 
     * Active touch points on the touch device. One event per any changed point (compared to
     * previous touch event in a sequence) is generated, emulating pressing/moving/releasing points
     * one by one.
     * 
     * @param modifiers 
     * Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8
     * (default: 0).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param timestamp Time at which the event occurred.
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> dispatchTouchEvent
        (String type, Input.TouchPoint[] touchPoints, Integer modifiers, Number timestamp)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (type == null)        BRDPC.throwNPE("type");
        if (touchPoints == null) BRDPC.throwNPE("touchPoints");
        
        // Exception-Check(s) to ensure that if any parameters which must adhere to a
        // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
        
        BRDPC.checkIAE(
            "type", type,
            "touchStart", "touchEnd", "touchMove", "touchCancel"
        );
        
        final int       webSocketID = 25005000 + counter++;
        final boolean[] optionals   = { false, false, true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("dispatchTouchEvent"),
            parameterNames.get("dispatchTouchEvent"),
            optionals, webSocketID,
            "Input.dispatchTouchEvent",
            type, touchPoints, modifiers, timestamp
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Emulates touch event from the mouse event parameters.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param type Type of the mouse event.
     * <BR />Acceptable Values: ["mousePressed", "mouseReleased", "mouseMoved", "mouseWheel"]
     * 
     * @param x X coordinate of the mouse pointer in DIP.
     * 
     * @param y Y coordinate of the mouse pointer in DIP.
     * 
     * @param button Mouse button. Only "none", "left", "right" are supported.
     * 
     * @param timestamp Time at which the event occurred (default: current time).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param deltaX X delta in DIP for mouse wheel event (default: 0).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param deltaY Y delta in DIP for mouse wheel event (default: 0).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param modifiers 
     * Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8
     * (default: 0).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param clickCount Number of times the mouse button was clicked (default: 0).
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> emulateTouchFromMouseEvent(
            String type, int x, int y, String button, Number timestamp, Number deltaX, 
            Number deltaY, Integer modifiers, Integer clickCount
        )
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (type == null)   BRDPC.throwNPE("type");
        if (button == null) BRDPC.throwNPE("button");
        
        // Exception-Check(s) to ensure that if any parameters which must adhere to a
        // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
        
        BRDPC.checkIAE(
            "type", type,
            "mousePressed", "mouseReleased", "mouseMoved", "mouseWheel"
        );
        BRDPC.checkIAE("button", button, "Input.MouseButton", Input.MouseButton);
        
        final int       webSocketID = 25006000 + counter++;
        final boolean[] optionals   = { false, false, false, false, true, true, true, true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("emulateTouchFromMouseEvent"),
            parameterNames.get("emulateTouchFromMouseEvent"),
            optionals, webSocketID,
            "Input.emulateTouchFromMouseEvent",
            type, x, y, button, timestamp, deltaX, deltaY, modifiers, clickCount
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Ignores input events (useful while auditing page).
     * 
     * @param ignore Ignores input events processing when set to true.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> setIgnoreInputEvents(boolean ignore)
    {
        final int       webSocketID = 25007000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setIgnoreInputEvents"),
            parameterNames.get("setIgnoreInputEvents"),
            optionals, webSocketID,
            "Input.setIgnoreInputEvents",
            ignore
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Prevents default drag and drop behavior and instead emits <CODE>Input.dragIntercepted</CODE> events.
     * Drag and drop behavior can be directly controlled via <CODE>Input.dispatchDragEvent</CODE>.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param enabled -
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> setInterceptDrags(boolean enabled)
    {
        final int       webSocketID = 25008000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setInterceptDrags"),
            parameterNames.get("setInterceptDrags"),
            optionals, webSocketID,
            "Input.setInterceptDrags",
            enabled
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Synthesizes a pinch gesture over a time period by issuing appropriate touch events.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param x X coordinate of the start of the gesture in CSS pixels.
     * 
     * @param y Y coordinate of the start of the gesture in CSS pixels.
     * 
     * @param scaleFactor Relative scale factor after zooming (&gt;1.0 zooms in, &lt;1.0 zooms out).
     * 
     * @param relativeSpeed Relative pointer speed in pixels per second (default: 800).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param gestureSourceType 
     * Which type of input events to be generated (default: 'default', which queries the platform
     * for the preferred input type).
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> synthesizePinchGesture
        (Number x, Number y, Number scaleFactor, Integer relativeSpeed, String gestureSourceType)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (x == null)           BRDPC.throwNPE("x");
        if (y == null)           BRDPC.throwNPE("y");
        if (scaleFactor == null) BRDPC.throwNPE("scaleFactor");
        
        // Exception-Check(s) to ensure that if any parameters which must adhere to a
        // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
        
        BRDPC.checkIAE("gestureSourceType", gestureSourceType, "Input.GestureSourceType", Input.GestureSourceType);
        
        final int       webSocketID = 25009000 + counter++;
        final boolean[] optionals   = { false, false, false, true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("synthesizePinchGesture"),
            parameterNames.get("synthesizePinchGesture"),
            optionals, webSocketID,
            "Input.synthesizePinchGesture",
            x, y, scaleFactor, relativeSpeed, gestureSourceType
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Synthesizes a scroll gesture over a time period by issuing appropriate touch events.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param x X coordinate of the start of the gesture in CSS pixels.
     * 
     * @param y Y coordinate of the start of the gesture in CSS pixels.
     * 
     * @param xDistance The distance to scroll along the X axis (positive to scroll left).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param yDistance The distance to scroll along the Y axis (positive to scroll up).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param xOverscroll 
     * The number of additional pixels to scroll back along the X axis, in addition to the given
     * distance.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param yOverscroll 
     * The number of additional pixels to scroll back along the Y axis, in addition to the given
     * distance.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param preventFling Prevent fling (default: true).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param speed Swipe speed in pixels per second (default: 800).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param gestureSourceType 
     * Which type of input events to be generated (default: 'default', which queries the platform
     * for the preferred input type).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param repeatCount The number of times to repeat the gesture (default: 0).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param repeatDelayMs The number of milliseconds delay between each repeat. (default: 250).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param interactionMarkerName The name of the interaction markers to generate, if not empty (default: "").
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> synthesizeScrollGesture(
            Number x, Number y, Number xDistance, Number yDistance, Number xOverscroll, 
            Number yOverscroll, Boolean preventFling, Integer speed, String gestureSourceType, 
            Integer repeatCount, Integer repeatDelayMs, String interactionMarkerName
        )
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (x == null) BRDPC.throwNPE("x");
        if (y == null) BRDPC.throwNPE("y");
        
        // Exception-Check(s) to ensure that if any parameters which must adhere to a
        // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
        
        BRDPC.checkIAE("gestureSourceType", gestureSourceType, "Input.GestureSourceType", Input.GestureSourceType);
        
        final int       webSocketID = 25010000 + counter++;
        final boolean[] optionals   = { false, false, true, true, true, true, true, true, true, true, true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("synthesizeScrollGesture"),
            parameterNames.get("synthesizeScrollGesture"),
            optionals, webSocketID,
            "Input.synthesizeScrollGesture",
            x, y, xDistance, yDistance, xOverscroll, yOverscroll, preventFling, speed,
            gestureSourceType, repeatCount, repeatDelayMs, interactionMarkerName
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Synthesizes a tap gesture over a time period by issuing appropriate touch events.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param x X coordinate of the start of the gesture in CSS pixels.
     * 
     * @param y Y coordinate of the start of the gesture in CSS pixels.
     * 
     * @param duration Duration between touchdown and touchup events in ms (default: 50).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param tapCount Number of times to perform the tap (e.g. 2 for double tap, default: 1).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param gestureSourceType 
     * Which type of input events to be generated (default: 'default', which queries the platform
     * for the preferred input type).
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> synthesizeTapGesture
        (Number x, Number y, Integer duration, Integer tapCount, String gestureSourceType)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (x == null) BRDPC.throwNPE("x");
        if (y == null) BRDPC.throwNPE("y");
        
        // Exception-Check(s) to ensure that if any parameters which must adhere to a
        // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
        
        BRDPC.checkIAE("gestureSourceType", gestureSourceType, "Input.GestureSourceType", Input.GestureSourceType);
        
        final int       webSocketID = 25011000 + counter++;
        final boolean[] optionals   = { false, false, true, true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("synthesizeTapGesture"),
            parameterNames.get("synthesizeTapGesture"),
            optionals, webSocketID,
            "Input.synthesizeTapGesture",
            x, y, duration, tapCount, gestureSourceType
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
}