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>This domain exposes CSS read/write operations. All CSS objects (stylesheets, rules, and styles)
 * have an associated <CODE>id</CODE> used in subsequent operations on the related object. Each object type has
 * a specific <CODE>id</CODE> structure, and those are not interchangeable between objects of different kinds.
 * CSS objects can be loaded using the <CODE>get*ForNode()</CODE> calls (which accept a DOM node id). A client
 * can also keep track of stylesheets via the <CODE>styleSheetAdded</CODE>/<CODE>styleSheetRemoved</CODE> events and
 * subsequently load the required stylesheet contents using the <CODE>getStyleSheet[Text]()</CODE> methods.</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 CSS
{
    // ********************************************************************************************
    // ********************************************************************************************
    // Class Header Stuff
    // ********************************************************************************************
    // ********************************************************************************************


    // No Pubic Constructors
    private CSS () { }

    // 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 : CSS.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>(3);
        parameterNames.put("addRule", v);
        Collections.addAll(v, new String[]
        { "styleSheetId", "ruleText", "location", });

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

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

        parameterNames.put("disable", EMPTY_VEC_STR);

        parameterNames.put("enable", EMPTY_VEC_STR);

        v = new Vector<String>(2);
        parameterNames.put("forcePseudoState", v);
        Collections.addAll(v, new String[]
        { "nodeId", "forcedPseudoClasses", });

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

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

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

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

        parameterNames.put("getMediaQueries", EMPTY_VEC_STR);

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

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

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

        parameterNames.put("takeComputedStyleUpdates", EMPTY_VEC_STR);

        v = new Vector<String>(3);
        parameterNames.put("setEffectivePropertyValueForNode", v);
        Collections.addAll(v, new String[]
        { "nodeId", "propertyName", "value", });

        v = new Vector<String>(3);
        parameterNames.put("setKeyframeKey", v);
        Collections.addAll(v, new String[]
        { "styleSheetId", "range", "keyText", });

        v = new Vector<String>(3);
        parameterNames.put("setMediaText", v);
        Collections.addAll(v, new String[]
        { "styleSheetId", "range", "text", });

        v = new Vector<String>(3);
        parameterNames.put("setContainerQueryText", v);
        Collections.addAll(v, new String[]
        { "styleSheetId", "range", "text", });

        v = new Vector<String>(3);
        parameterNames.put("setRuleSelector", v);
        Collections.addAll(v, new String[]
        { "styleSheetId", "range", "selector", });

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

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

        parameterNames.put("startRuleUsageTracking", EMPTY_VEC_STR);

        parameterNames.put("stopRuleUsageTracking", EMPTY_VEC_STR);

        parameterNames.put("takeCoverageDelta", EMPTY_VEC_STR);

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


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

    // public static class StyleSheetId => String
    
    /**
     * Stylesheet type: "injected" for stylesheets injected via extension, "user-agent" for user-agent
     * stylesheets, "inspector" for stylesheets created by the inspector (i.e. those holding the "via
     * inspector" rules), "regular" for regular stylesheets.
     */
    public static final String[] StyleSheetOrigin =
    { "injected", "user-agent", "inspector", "regular", };
    
    /** CSS rule collection for a single pseudo style. */
    public static class PseudoElementMatches
        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, }; }
        
        /** Pseudo element type. */
        public final String pseudoType;
        
        /** Matches of CSS rules applicable to the pseudo style. */
        public final CSS.RuleMatch[] matches;
        
        /**
         * Constructor
         *
         * @param pseudoType Pseudo element type.
         * 
         * @param matches Matches of CSS rules applicable to the pseudo style.
         */
        public PseudoElementMatches(String pseudoType, CSS.RuleMatch[] matches)
        {
            // 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 (pseudoType == null) BRDPC.throwNPE("pseudoType");
            if (matches == null)    BRDPC.throwNPE("matches");
            
            // 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("pseudoType", pseudoType, "DOM.PseudoType", DOM.PseudoType);
            
            this.pseudoType  = pseudoType;
            this.matches     = matches;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'PseudoElementMatches'}.
         */
        public PseudoElementMatches (JsonObject jo)
        {
            this.pseudoType  = ReadJSON.getString(jo, "pseudoType", false, true);
            this.matches = (jo.getJsonArray("matches") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("matches"), null, 0, CSS.RuleMatch[].class);
        
        }
        
        
        /** 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;
        
            PseudoElementMatches o = (PseudoElementMatches) other;
        
            return
                    Objects.equals(this.pseudoType, o.pseudoType)
                &&  Arrays.deepEquals(this.matches, o.matches);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.pseudoType)
                +   Arrays.deepHashCode(this.matches);
        }
    }
    
    /** Inherited CSS rule collection from ancestor node. */
    public static class InheritedStyleEntry
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { true, false, }; }
        
        /**
         * The ancestor node's inline style, if any, in the style inheritance chain.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final CSS.CSSStyle inlineStyle;
        
        /** Matches of CSS rules matching the ancestor node in the style inheritance chain. */
        public final CSS.RuleMatch[] matchedCSSRules;
        
        /**
         * Constructor
         *
         * @param inlineStyle The ancestor node's inline style, if any, in the style inheritance chain.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param matchedCSSRules Matches of CSS rules matching the ancestor node in the style inheritance chain.
         */
        public InheritedStyleEntry(CSS.CSSStyle inlineStyle, CSS.RuleMatch[] matchedCSSRules)
        {
            // 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 (matchedCSSRules == null) BRDPC.throwNPE("matchedCSSRules");
            
            this.inlineStyle      = inlineStyle;
            this.matchedCSSRules  = matchedCSSRules;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'InheritedStyleEntry'}.
         */
        public InheritedStyleEntry (JsonObject jo)
        {
            this.inlineStyle      = ReadJSON.getObject(jo, "inlineStyle", CSS.CSSStyle.class, true, false);
            this.matchedCSSRules = (jo.getJsonArray("matchedCSSRules") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("matchedCSSRules"), null, 0, CSS.RuleMatch[].class);
        
        }
        
        
        /** 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;
        
            InheritedStyleEntry o = (InheritedStyleEntry) other;
        
            return
                    Objects.equals(this.inlineStyle, o.inlineStyle)
                &&  Arrays.deepEquals(this.matchedCSSRules, o.matchedCSSRules);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.inlineStyle.hashCode()
                +   Arrays.deepHashCode(this.matchedCSSRules);
        }
    }
    
    /** Match data for a CSS rule. */
    public static class RuleMatch
        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, }; }
        
        /** CSS rule in the match. */
        public final CSS.CSSRule rule;
        
        /** Matching selector indices in the rule's selectorList selectors (0-based). */
        public final int[] matchingSelectors;
        
        /**
         * Constructor
         *
         * @param rule CSS rule in the match.
         * 
         * @param matchingSelectors Matching selector indices in the rule's selectorList selectors (0-based).
         */
        public RuleMatch(CSS.CSSRule rule, int[] matchingSelectors)
        {
            // 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 (rule == null)              BRDPC.throwNPE("rule");
            if (matchingSelectors == null) BRDPC.throwNPE("matchingSelectors");
            
            this.rule               = rule;
            this.matchingSelectors  = matchingSelectors;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'RuleMatch'}.
         */
        public RuleMatch (JsonObject jo)
        {
            this.rule               = ReadJSON.getObject(jo, "rule", CSS.CSSRule.class, false, true);
            this.matchingSelectors = (jo.getJsonArray("matchingSelectors") == null)
                ? null
                : ReadArrJSON.DimN.intArr(jo.getJsonArray("matchingSelectors"), -1, 0, null, int[].class);
        
        }
        
        
        /** 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;
        
            RuleMatch o = (RuleMatch) other;
        
            return
                    Objects.equals(this.rule, o.rule)
                &&  Arrays.equals(this.matchingSelectors, o.matchingSelectors);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.rule.hashCode()
                +   Arrays.hashCode(this.matchingSelectors);
        }
    }
    
    /** Data for a simple selector (these are delimited by commas in a selector list). */
    public static class Value
        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, }; }
        
        /** Value text. */
        public final String text;
        
        /**
         * Value range in the underlying resource (if available).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final CSS.SourceRange range;
        
        /**
         * Constructor
         *
         * @param text Value text.
         * 
         * @param range Value range in the underlying resource (if available).
         * <BR /><B>OPTIONAL</B>
         */
        public Value(String text, CSS.SourceRange range)
        {
            // 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");
            
            this.text   = text;
            this.range  = range;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'Value'}.
         */
        public Value (JsonObject jo)
        {
            this.text   = ReadJSON.getString(jo, "text", false, true);
            this.range  = ReadJSON.getObject(jo, "range", CSS.SourceRange.class, 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;
        
            Value o = (Value) other;
        
            return
                    Objects.equals(this.text, o.text)
                &&  Objects.equals(this.range, o.range);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.text)
                +   this.range.hashCode();
        }
    }
    
    /** Selector list data. */
    public static class SelectorList
        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, }; }
        
        /** Selectors in the list. */
        public final CSS.Value[] selectors;
        
        /** Rule selector text. */
        public final String text;
        
        /**
         * Constructor
         *
         * @param selectors Selectors in the list.
         * 
         * @param text Rule selector text.
         */
        public SelectorList(CSS.Value[] selectors, 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 (selectors == null) BRDPC.throwNPE("selectors");
            if (text == null)      BRDPC.throwNPE("text");
            
            this.selectors  = selectors;
            this.text       = text;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'SelectorList'}.
         */
        public SelectorList (JsonObject jo)
        {
            this.selectors = (jo.getJsonArray("selectors") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("selectors"), null, 0, CSS.Value[].class);
        
            this.text       = ReadJSON.getString(jo, "text", 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;
        
            SelectorList o = (SelectorList) other;
        
            return
                    Arrays.deepEquals(this.selectors, o.selectors)
                &&  Objects.equals(this.text, o.text);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Arrays.deepHashCode(this.selectors)
                +   Objects.hashCode(this.text);
        }
    }
    
    /** CSS stylesheet metainformation. */
    public static class CSSStyleSheetHeader
        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, false, true, false, false, true, false, true, false, false, false, false, false, false, false, false, }; }
        
        /** The stylesheet identifier. */
        public final String styleSheetId;
        
        /** Owner frame identifier. */
        public final String frameId;
        
        /**
         * Stylesheet resource URL. Empty if this is a constructed stylesheet created using
         * new CSSStyleSheet() (but non-empty if this is a constructed sylesheet imported
         * as a CSS module script).
         */
        public final String sourceURL;
        
        /**
         * URL of source map associated with the stylesheet (if any).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String sourceMapURL;
        
        /** Stylesheet origin. */
        public final String origin;
        
        /** Stylesheet title. */
        public final String title;
        
        /**
         * The backend id for the owner node of the stylesheet.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Integer ownerNode;
        
        /** Denotes whether the stylesheet is disabled. */
        public final boolean disabled;
        
        /**
         * Whether the sourceURL field value comes from the sourceURL comment.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Boolean hasSourceURL;
        
        /**
         * Whether this stylesheet is created for STYLE tag by parser. This flag is not set for
         * document.written STYLE tags.
         */
        public final boolean isInline;
        
        /**
         * Whether this stylesheet is mutable. Inline stylesheets become mutable
         * after they have been modified via CSSOM API.
         * &lt;link&gt; element's stylesheets become mutable only if DevTools modifies them.
         * Constructed stylesheets (new CSSStyleSheet()) are mutable immediately after creation.
         */
        public final boolean isMutable;
        
        /**
         * True if this stylesheet is created through new CSSStyleSheet() or imported as a
         * CSS module script.
         */
        public final boolean isConstructed;
        
        /** Line offset of the stylesheet within the resource (zero based). */
        public final Number startLine;
        
        /** Column offset of the stylesheet within the resource (zero based). */
        public final Number startColumn;
        
        /** Size of the content (in characters). */
        public final Number length;
        
        /** Line offset of the end of the stylesheet within the resource (zero based). */
        public final Number endLine;
        
        /** Column offset of the end of the stylesheet within the resource (zero based). */
        public final Number endColumn;
        
        /**
         * Constructor
         *
         * @param styleSheetId The stylesheet identifier.
         * 
         * @param frameId Owner frame identifier.
         * 
         * @param sourceURL 
         * Stylesheet resource URL. Empty if this is a constructed stylesheet created using
         * new CSSStyleSheet() (but non-empty if this is a constructed sylesheet imported
         * as a CSS module script).
         * 
         * @param sourceMapURL URL of source map associated with the stylesheet (if any).
         * <BR /><B>OPTIONAL</B>
         * 
         * @param origin Stylesheet origin.
         * 
         * @param title Stylesheet title.
         * 
         * @param ownerNode The backend id for the owner node of the stylesheet.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param disabled Denotes whether the stylesheet is disabled.
         * 
         * @param hasSourceURL Whether the sourceURL field value comes from the sourceURL comment.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param isInline 
         * Whether this stylesheet is created for STYLE tag by parser. This flag is not set for
         * document.written STYLE tags.
         * 
         * @param isMutable 
         * Whether this stylesheet is mutable. Inline stylesheets become mutable
         * after they have been modified via CSSOM API.
         * &lt;link&gt; element's stylesheets become mutable only if DevTools modifies them.
         * Constructed stylesheets (new CSSStyleSheet()) are mutable immediately after creation.
         * 
         * @param isConstructed 
         * True if this stylesheet is created through new CSSStyleSheet() or imported as a
         * CSS module script.
         * 
         * @param startLine Line offset of the stylesheet within the resource (zero based).
         * 
         * @param startColumn Column offset of the stylesheet within the resource (zero based).
         * 
         * @param length Size of the content (in characters).
         * 
         * @param endLine Line offset of the end of the stylesheet within the resource (zero based).
         * 
         * @param endColumn Column offset of the end of the stylesheet within the resource (zero based).
         */
        public CSSStyleSheetHeader(
                String styleSheetId, String frameId, String sourceURL, String sourceMapURL, 
                String origin, String title, Integer ownerNode, boolean disabled, 
                Boolean hasSourceURL, boolean isInline, boolean isMutable, boolean isConstructed, 
                Number startLine, Number startColumn, Number length, Number endLine, Number endColumn
            )
        {
            // 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 (styleSheetId == null) BRDPC.throwNPE("styleSheetId");
            if (frameId == null)      BRDPC.throwNPE("frameId");
            if (sourceURL == null)    BRDPC.throwNPE("sourceURL");
            if (origin == null)       BRDPC.throwNPE("origin");
            if (title == null)        BRDPC.throwNPE("title");
            if (startLine == null)    BRDPC.throwNPE("startLine");
            if (startColumn == null)  BRDPC.throwNPE("startColumn");
            if (length == null)       BRDPC.throwNPE("length");
            if (endLine == null)      BRDPC.throwNPE("endLine");
            if (endColumn == null)    BRDPC.throwNPE("endColumn");
            
            // 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("origin", origin, "CSS.StyleSheetOrigin", CSS.StyleSheetOrigin);
            
            this.styleSheetId   = styleSheetId;
            this.frameId        = frameId;
            this.sourceURL      = sourceURL;
            this.sourceMapURL   = sourceMapURL;
            this.origin         = origin;
            this.title          = title;
            this.ownerNode      = ownerNode;
            this.disabled       = disabled;
            this.hasSourceURL   = hasSourceURL;
            this.isInline       = isInline;
            this.isMutable      = isMutable;
            this.isConstructed  = isConstructed;
            this.startLine      = startLine;
            this.startColumn    = startColumn;
            this.length         = length;
            this.endLine        = endLine;
            this.endColumn      = endColumn;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'CSSStyleSheetHeader'}.
         */
        public CSSStyleSheetHeader (JsonObject jo)
        {
            this.styleSheetId   = ReadJSON.getString(jo, "styleSheetId", false, true);
            this.frameId        = ReadJSON.getString(jo, "frameId", false, true);
            this.sourceURL      = ReadJSON.getString(jo, "sourceURL", false, true);
            this.sourceMapURL   = ReadJSON.getString(jo, "sourceMapURL", true, false);
            this.origin         = ReadJSON.getString(jo, "origin", false, true);
            this.title          = ReadJSON.getString(jo, "title", false, true);
            this.ownerNode      = ReadBoxedJSON.getInteger(jo, "ownerNode", true);
            this.disabled       = ReadPrimJSON.getBoolean(jo, "disabled");
            this.hasSourceURL   = ReadBoxedJSON.getBoolean(jo, "hasSourceURL", true);
            this.isInline       = ReadPrimJSON.getBoolean(jo, "isInline");
            this.isMutable      = ReadPrimJSON.getBoolean(jo, "isMutable");
            this.isConstructed  = ReadPrimJSON.getBoolean(jo, "isConstructed");
            this.startLine      = ReadNumberJSON.get(jo, "startLine", false, true);
            this.startColumn    = ReadNumberJSON.get(jo, "startColumn", false, true);
            this.length         = ReadNumberJSON.get(jo, "length", false, true);
            this.endLine        = ReadNumberJSON.get(jo, "endLine", false, true);
            this.endColumn      = ReadNumberJSON.get(jo, "endColumn", 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;
        
            CSSStyleSheetHeader o = (CSSStyleSheetHeader) other;
        
            return
                    Objects.equals(this.styleSheetId, o.styleSheetId)
                &&  Objects.equals(this.frameId, o.frameId)
                &&  Objects.equals(this.sourceURL, o.sourceURL)
                &&  Objects.equals(this.sourceMapURL, o.sourceMapURL)
                &&  Objects.equals(this.origin, o.origin)
                &&  Objects.equals(this.title, o.title)
                &&  Objects.equals(this.ownerNode, o.ownerNode)
                &&  (this.disabled == o.disabled)
                &&  Objects.equals(this.hasSourceURL, o.hasSourceURL)
                &&  (this.isInline == o.isInline)
                &&  (this.isMutable == o.isMutable)
                &&  (this.isConstructed == o.isConstructed)
                &&  Objects.equals(this.startLine, o.startLine)
                &&  Objects.equals(this.startColumn, o.startColumn)
                &&  Objects.equals(this.length, o.length)
                &&  Objects.equals(this.endLine, o.endLine)
                &&  Objects.equals(this.endColumn, o.endColumn);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.styleSheetId)
                +   Objects.hashCode(this.frameId)
                +   Objects.hashCode(this.sourceURL)
                +   Objects.hashCode(this.sourceMapURL)
                +   Objects.hashCode(this.origin)
                +   Objects.hashCode(this.title)
                +   Objects.hashCode(this.ownerNode)
                +   (this.disabled ? 1 : 0)
                +   Objects.hashCode(this.hasSourceURL)
                +   (this.isInline ? 1 : 0)
                +   (this.isMutable ? 1 : 0)
                +   (this.isConstructed ? 1 : 0)
                +   Objects.hashCode(this.startLine)
                +   Objects.hashCode(this.startColumn)
                +   Objects.hashCode(this.length)
                +   Objects.hashCode(this.endLine)
                +   Objects.hashCode(this.endColumn);
        }
    }
    
    /** CSS rule representation. */
    public static class CSSRule
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { true, false, false, false, true, true, }; }
        
        /**
         * The css style sheet identifier (absent for user agent stylesheet and user-specified
         * stylesheet rules) this rule came from.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String styleSheetId;
        
        /** Rule selector data. */
        public final CSS.SelectorList selectorList;
        
        /** Parent stylesheet's origin. */
        public final String origin;
        
        /** Associated style declaration. */
        public final CSS.CSSStyle style;
        
        /**
         * Media list array (for rules involving media queries). The array enumerates media queries
         * starting with the innermost one, going outwards.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final CSS.CSSMedia[] media;
        
        /**
         * Container query list array (for rules involving container queries).
         * The array enumerates container queries starting with the innermost one, going outwards.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         */
        public final CSS.CSSContainerQuery[] containerQueries;
        
        /**
         * Constructor
         *
         * @param styleSheetId 
         * The css style sheet identifier (absent for user agent stylesheet and user-specified
         * stylesheet rules) this rule came from.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param selectorList Rule selector data.
         * 
         * @param origin Parent stylesheet's origin.
         * 
         * @param style Associated style declaration.
         * 
         * @param media 
         * Media list array (for rules involving media queries). The array enumerates media queries
         * starting with the innermost one, going outwards.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param containerQueries 
         * Container query list array (for rules involving container queries).
         * The array enumerates container queries starting with the innermost one, going outwards.
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         */
        public CSSRule(
                String styleSheetId, CSS.SelectorList selectorList, String origin, 
                CSS.CSSStyle style, CSS.CSSMedia[] media, CSS.CSSContainerQuery[] containerQueries
            )
        {
            // 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 (selectorList == null) BRDPC.throwNPE("selectorList");
            if (origin == null)       BRDPC.throwNPE("origin");
            if (style == null)        BRDPC.throwNPE("style");
            
            // 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("origin", origin, "CSS.StyleSheetOrigin", CSS.StyleSheetOrigin);
            
            this.styleSheetId      = styleSheetId;
            this.selectorList      = selectorList;
            this.origin            = origin;
            this.style             = style;
            this.media             = media;
            this.containerQueries  = containerQueries;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'CSSRule'}.
         */
        public CSSRule (JsonObject jo)
        {
            this.styleSheetId      = ReadJSON.getString(jo, "styleSheetId", true, false);
            this.selectorList      = ReadJSON.getObject(jo, "selectorList", CSS.SelectorList.class, false, true);
            this.origin            = ReadJSON.getString(jo, "origin", false, true);
            this.style             = ReadJSON.getObject(jo, "style", CSS.CSSStyle.class, false, true);
            this.media = (jo.getJsonArray("media") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("media"), null, 0, CSS.CSSMedia[].class);
        
            this.containerQueries = (jo.getJsonArray("containerQueries") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("containerQueries"), null, 0, CSS.CSSContainerQuery[].class);
        
        }
        
        
        /** 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;
        
            CSSRule o = (CSSRule) other;
        
            return
                    Objects.equals(this.styleSheetId, o.styleSheetId)
                &&  Objects.equals(this.selectorList, o.selectorList)
                &&  Objects.equals(this.origin, o.origin)
                &&  Objects.equals(this.style, o.style)
                &&  Arrays.deepEquals(this.media, o.media)
                &&  Arrays.deepEquals(this.containerQueries, o.containerQueries);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.styleSheetId)
                +   this.selectorList.hashCode()
                +   Objects.hashCode(this.origin)
                +   this.style.hashCode()
                +   Arrays.deepHashCode(this.media)
                +   Arrays.deepHashCode(this.containerQueries);
        }
    }
    
    /** CSS coverage information. */
    public static class RuleUsage
        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, false, false, }; }
        
        /**
         * The css style sheet identifier (absent for user agent stylesheet and user-specified
         * stylesheet rules) this rule came from.
         */
        public final String styleSheetId;
        
        /** Offset of the start of the rule (including selector) from the beginning of the stylesheet. */
        public final Number startOffset;
        
        /** Offset of the end of the rule body from the beginning of the stylesheet. */
        public final Number endOffset;
        
        /** Indicates whether the rule was actually used by some element in the page. */
        public final boolean used;
        
        /**
         * Constructor
         *
         * @param styleSheetId 
         * The css style sheet identifier (absent for user agent stylesheet and user-specified
         * stylesheet rules) this rule came from.
         * 
         * @param startOffset Offset of the start of the rule (including selector) from the beginning of the stylesheet.
         * 
         * @param endOffset Offset of the end of the rule body from the beginning of the stylesheet.
         * 
         * @param used Indicates whether the rule was actually used by some element in the page.
         */
        public RuleUsage
            (String styleSheetId, Number startOffset, Number endOffset, boolean used)
        {
            // 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 (styleSheetId == null) BRDPC.throwNPE("styleSheetId");
            if (startOffset == null)  BRDPC.throwNPE("startOffset");
            if (endOffset == null)    BRDPC.throwNPE("endOffset");
            
            this.styleSheetId  = styleSheetId;
            this.startOffset   = startOffset;
            this.endOffset     = endOffset;
            this.used          = used;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'RuleUsage'}.
         */
        public RuleUsage (JsonObject jo)
        {
            this.styleSheetId  = ReadJSON.getString(jo, "styleSheetId", false, true);
            this.startOffset   = ReadNumberJSON.get(jo, "startOffset", false, true);
            this.endOffset     = ReadNumberJSON.get(jo, "endOffset", false, true);
            this.used          = ReadPrimJSON.getBoolean(jo, "used");
        }
        
        
        /** 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;
        
            RuleUsage o = (RuleUsage) other;
        
            return
                    Objects.equals(this.styleSheetId, o.styleSheetId)
                &&  Objects.equals(this.startOffset, o.startOffset)
                &&  Objects.equals(this.endOffset, o.endOffset)
                &&  (this.used == o.used);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.styleSheetId)
                +   Objects.hashCode(this.startOffset)
                +   Objects.hashCode(this.endOffset)
                +   (this.used ? 1 : 0);
        }
    }
    
    /** Text range within a resource. All numbers are zero-based. */
    public static class SourceRange
        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, false, false, }; }
        
        /** Start line of range. */
        public final int startLine;
        
        /** Start column of range (inclusive). */
        public final int startColumn;
        
        /** End line of range */
        public final int endLine;
        
        /** End column of range (exclusive). */
        public final int endColumn;
        
        /**
         * Constructor
         *
         * @param startLine Start line of range.
         * 
         * @param startColumn Start column of range (inclusive).
         * 
         * @param endLine End line of range
         * 
         * @param endColumn End column of range (exclusive).
         */
        public SourceRange(int startLine, int startColumn, int endLine, int endColumn)
        {
            this.startLine    = startLine;
            this.startColumn  = startColumn;
            this.endLine      = endLine;
            this.endColumn    = endColumn;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'SourceRange'}.
         */
        public SourceRange (JsonObject jo)
        {
            this.startLine    = ReadPrimJSON.getInt(jo, "startLine");
            this.startColumn  = ReadPrimJSON.getInt(jo, "startColumn");
            this.endLine      = ReadPrimJSON.getInt(jo, "endLine");
            this.endColumn    = ReadPrimJSON.getInt(jo, "endColumn");
        }
        
        
        /** 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;
        
            SourceRange o = (SourceRange) other;
        
            return
                    (this.startLine == o.startLine)
                &&  (this.startColumn == o.startColumn)
                &&  (this.endLine == o.endLine)
                &&  (this.endColumn == o.endColumn);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.startLine
                +   this.startColumn
                +   this.endLine
                +   this.endColumn;
        }
    }
    
    /** <CODE>[No Description Provided by Google]</CODE> */
    public static class ShorthandEntry
        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, }; }
        
        /** Shorthand name. */
        public final String name;
        
        /** Shorthand value. */
        public final String value;
        
        /**
         * Whether the property has "!important" annotation (implies <CODE>false</CODE> if absent).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Boolean important;
        
        /**
         * Constructor
         *
         * @param name Shorthand name.
         * 
         * @param value Shorthand value.
         * 
         * @param important Whether the property has "!important" annotation (implies <CODE>false</CODE> if absent).
         * <BR /><B>OPTIONAL</B>
         */
        public ShorthandEntry(String name, String value, Boolean important)
        {
            // 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 (name == null)  BRDPC.throwNPE("name");
            if (value == null) BRDPC.throwNPE("value");
            
            this.name       = name;
            this.value      = value;
            this.important  = important;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'ShorthandEntry'}.
         */
        public ShorthandEntry (JsonObject jo)
        {
            this.name       = ReadJSON.getString(jo, "name", false, true);
            this.value      = ReadJSON.getString(jo, "value", false, true);
            this.important  = ReadBoxedJSON.getBoolean(jo, "important", 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;
        
            ShorthandEntry o = (ShorthandEntry) other;
        
            return
                    Objects.equals(this.name, o.name)
                &&  Objects.equals(this.value, o.value)
                &&  Objects.equals(this.important, o.important);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.name)
                +   Objects.hashCode(this.value)
                +   Objects.hashCode(this.important);
        }
    }
    
    /** <CODE>[No Description Provided by Google]</CODE> */
    public static class CSSComputedStyleProperty
        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, }; }
        
        /** Computed style property name. */
        public final String name;
        
        /** Computed style property value. */
        public final String value;
        
        /**
         * Constructor
         *
         * @param name Computed style property name.
         * 
         * @param value Computed style property value.
         */
        public CSSComputedStyleProperty(String name, String value)
        {
            // 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 (name == null)  BRDPC.throwNPE("name");
            if (value == null) BRDPC.throwNPE("value");
            
            this.name   = name;
            this.value  = value;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'CSSComputedStyleProperty'}.
         */
        public CSSComputedStyleProperty (JsonObject jo)
        {
            this.name   = ReadJSON.getString(jo, "name", false, true);
            this.value  = ReadJSON.getString(jo, "value", 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;
        
            CSSComputedStyleProperty o = (CSSComputedStyleProperty) other;
        
            return
                    Objects.equals(this.name, o.name)
                &&  Objects.equals(this.value, o.value);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.name)
                +   Objects.hashCode(this.value);
        }
    }
    
    /** CSS style representation. */
    public static class CSSStyle
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { true, false, false, true, true, }; }
        
        /**
         * The css style sheet identifier (absent for user agent stylesheet and user-specified
         * stylesheet rules) this rule came from.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String styleSheetId;
        
        /** CSS properties in the style. */
        public final CSS.CSSProperty[] cssProperties;
        
        /** Computed values for all shorthands found in the style. */
        public final CSS.ShorthandEntry[] shorthandEntries;
        
        /**
         * Style declaration text (if available).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String cssText;
        
        /**
         * Style declaration range in the enclosing stylesheet (if available).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final CSS.SourceRange range;
        
        /**
         * Constructor
         *
         * @param styleSheetId 
         * The css style sheet identifier (absent for user agent stylesheet and user-specified
         * stylesheet rules) this rule came from.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param cssProperties CSS properties in the style.
         * 
         * @param shorthandEntries Computed values for all shorthands found in the style.
         * 
         * @param cssText Style declaration text (if available).
         * <BR /><B>OPTIONAL</B>
         * 
         * @param range Style declaration range in the enclosing stylesheet (if available).
         * <BR /><B>OPTIONAL</B>
         */
        public CSSStyle(
                String styleSheetId, CSS.CSSProperty[] cssProperties, 
                CSS.ShorthandEntry[] shorthandEntries, String cssText, CSS.SourceRange range
            )
        {
            // 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 (cssProperties == null)    BRDPC.throwNPE("cssProperties");
            if (shorthandEntries == null) BRDPC.throwNPE("shorthandEntries");
            
            this.styleSheetId      = styleSheetId;
            this.cssProperties     = cssProperties;
            this.shorthandEntries  = shorthandEntries;
            this.cssText           = cssText;
            this.range             = range;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'CSSStyle'}.
         */
        public CSSStyle (JsonObject jo)
        {
            this.styleSheetId      = ReadJSON.getString(jo, "styleSheetId", true, false);
            this.cssProperties = (jo.getJsonArray("cssProperties") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("cssProperties"), null, 0, CSS.CSSProperty[].class);
        
            this.shorthandEntries = (jo.getJsonArray("shorthandEntries") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("shorthandEntries"), null, 0, CSS.ShorthandEntry[].class);
        
            this.cssText           = ReadJSON.getString(jo, "cssText", true, false);
            this.range             = ReadJSON.getObject(jo, "range", CSS.SourceRange.class, 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;
        
            CSSStyle o = (CSSStyle) other;
        
            return
                    Objects.equals(this.styleSheetId, o.styleSheetId)
                &&  Arrays.deepEquals(this.cssProperties, o.cssProperties)
                &&  Arrays.deepEquals(this.shorthandEntries, o.shorthandEntries)
                &&  Objects.equals(this.cssText, o.cssText)
                &&  Objects.equals(this.range, o.range);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.styleSheetId)
                +   Arrays.deepHashCode(this.cssProperties)
                +   Arrays.deepHashCode(this.shorthandEntries)
                +   Objects.hashCode(this.cssText)
                +   this.range.hashCode();
        }
    }
    
    /** CSS property declaration data. */
    public static class CSSProperty
        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, }; }
        
        /** The property name. */
        public final String name;
        
        /** The property value. */
        public final String value;
        
        /**
         * Whether the property has "!important" annotation (implies <CODE>false</CODE> if absent).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Boolean important;
        
        /**
         * Whether the property is implicit (implies <CODE>false</CODE> if absent).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Boolean implicit;
        
        /**
         * The full property text as specified in the style.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String text;
        
        /**
         * Whether the property is understood by the browser (implies <CODE>true</CODE> if absent).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Boolean parsedOk;
        
        /**
         * Whether the property is disabled by the user (present for source-based properties only).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Boolean disabled;
        
        /**
         * The entire property range in the enclosing style declaration (if available).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final CSS.SourceRange range;
        
        /**
         * Constructor
         *
         * @param name The property name.
         * 
         * @param value The property value.
         * 
         * @param important Whether the property has "!important" annotation (implies <CODE>false</CODE> if absent).
         * <BR /><B>OPTIONAL</B>
         * 
         * @param implicit Whether the property is implicit (implies <CODE>false</CODE> if absent).
         * <BR /><B>OPTIONAL</B>
         * 
         * @param text The full property text as specified in the style.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param parsedOk Whether the property is understood by the browser (implies <CODE>true</CODE> if absent).
         * <BR /><B>OPTIONAL</B>
         * 
         * @param disabled Whether the property is disabled by the user (present for source-based properties only).
         * <BR /><B>OPTIONAL</B>
         * 
         * @param range The entire property range in the enclosing style declaration (if available).
         * <BR /><B>OPTIONAL</B>
         */
        public CSSProperty(
                String name, String value, Boolean important, Boolean implicit, String text, 
                Boolean parsedOk, Boolean disabled, CSS.SourceRange range
            )
        {
            // 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 (name == null)  BRDPC.throwNPE("name");
            if (value == null) BRDPC.throwNPE("value");
            
            this.name       = name;
            this.value      = value;
            this.important  = important;
            this.implicit   = implicit;
            this.text       = text;
            this.parsedOk   = parsedOk;
            this.disabled   = disabled;
            this.range      = range;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'CSSProperty'}.
         */
        public CSSProperty (JsonObject jo)
        {
            this.name       = ReadJSON.getString(jo, "name", false, true);
            this.value      = ReadJSON.getString(jo, "value", false, true);
            this.important  = ReadBoxedJSON.getBoolean(jo, "important", true);
            this.implicit   = ReadBoxedJSON.getBoolean(jo, "implicit", true);
            this.text       = ReadJSON.getString(jo, "text", true, false);
            this.parsedOk   = ReadBoxedJSON.getBoolean(jo, "parsedOk", true);
            this.disabled   = ReadBoxedJSON.getBoolean(jo, "disabled", true);
            this.range      = ReadJSON.getObject(jo, "range", CSS.SourceRange.class, 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;
        
            CSSProperty o = (CSSProperty) other;
        
            return
                    Objects.equals(this.name, o.name)
                &&  Objects.equals(this.value, o.value)
                &&  Objects.equals(this.important, o.important)
                &&  Objects.equals(this.implicit, o.implicit)
                &&  Objects.equals(this.text, o.text)
                &&  Objects.equals(this.parsedOk, o.parsedOk)
                &&  Objects.equals(this.disabled, o.disabled)
                &&  Objects.equals(this.range, o.range);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.name)
                +   Objects.hashCode(this.value)
                +   Objects.hashCode(this.important)
                +   Objects.hashCode(this.implicit)
                +   Objects.hashCode(this.text)
                +   Objects.hashCode(this.parsedOk)
                +   Objects.hashCode(this.disabled)
                +   this.range.hashCode();
        }
    }
    
    /** CSS media rule descriptor. */
    public static class CSSMedia
        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, }; }
        
        /** Media query text. */
        public final String text;
        
        /**
         * Source of the media query: "mediaRule" if specified by a @media rule, "importRule" if
         * specified by an @import rule, "linkedSheet" if specified by a "media" attribute in a linked
         * stylesheet's LINK tag, "inlineSheet" if specified by a "media" attribute in an inline
         * stylesheet's STYLE tag.
         */
        public final String source;
        
        /**
         * URL of the document containing the media query description.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String sourceURL;
        
        /**
         * The associated rule (@media or @import) header range in the enclosing stylesheet (if
         * available).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final CSS.SourceRange range;
        
        /**
         * Identifier of the stylesheet containing this object (if exists).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String styleSheetId;
        
        /**
         * Array of media queries.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final CSS.MediaQuery[] mediaList;
        
        /**
         * Constructor
         *
         * @param text Media query text.
         * 
         * @param source 
         * Source of the media query: "mediaRule" if specified by a @media rule, "importRule" if
         * specified by an @import rule, "linkedSheet" if specified by a "media" attribute in a linked
         * stylesheet's LINK tag, "inlineSheet" if specified by a "media" attribute in an inline
         * stylesheet's STYLE tag.
         * <BR />Acceptable Values: ["mediaRule", "importRule", "linkedSheet", "inlineSheet"]
         * 
         * @param sourceURL URL of the document containing the media query description.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param range 
         * The associated rule (@media or @import) header range in the enclosing stylesheet (if
         * available).
         * <BR /><B>OPTIONAL</B>
         * 
         * @param styleSheetId Identifier of the stylesheet containing this object (if exists).
         * <BR /><B>OPTIONAL</B>
         * 
         * @param mediaList Array of media queries.
         * <BR /><B>OPTIONAL</B>
         */
        public CSSMedia(
                String text, String source, String sourceURL, CSS.SourceRange range, 
                String styleSheetId, CSS.MediaQuery[] mediaList
            )
        {
            // 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");
            if (source == null) BRDPC.throwNPE("source");
            
            // 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(
                "source", source,
                "mediaRule", "importRule", "linkedSheet", "inlineSheet"
            );
            
            this.text          = text;
            this.source        = source;
            this.sourceURL     = sourceURL;
            this.range         = range;
            this.styleSheetId  = styleSheetId;
            this.mediaList     = mediaList;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'CSSMedia'}.
         */
        public CSSMedia (JsonObject jo)
        {
            this.text          = ReadJSON.getString(jo, "text", false, true);
            this.source        = ReadJSON.getString(jo, "source", false, true);
            this.sourceURL     = ReadJSON.getString(jo, "sourceURL", true, false);
            this.range         = ReadJSON.getObject(jo, "range", CSS.SourceRange.class, true, false);
            this.styleSheetId  = ReadJSON.getString(jo, "styleSheetId", true, false);
            this.mediaList = (jo.getJsonArray("mediaList") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("mediaList"), null, 0, CSS.MediaQuery[].class);
        
        }
        
        
        /** 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;
        
            CSSMedia o = (CSSMedia) other;
        
            return
                    Objects.equals(this.text, o.text)
                &&  Objects.equals(this.source, o.source)
                &&  Objects.equals(this.sourceURL, o.sourceURL)
                &&  Objects.equals(this.range, o.range)
                &&  Objects.equals(this.styleSheetId, o.styleSheetId)
                &&  Arrays.deepEquals(this.mediaList, o.mediaList);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.text)
                +   Objects.hashCode(this.source)
                +   Objects.hashCode(this.sourceURL)
                +   this.range.hashCode()
                +   Objects.hashCode(this.styleSheetId)
                +   Arrays.deepHashCode(this.mediaList);
        }
    }
    
    /** Media query descriptor. */
    public static class MediaQuery
        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, }; }
        
        /** Array of media query expressions. */
        public final CSS.MediaQueryExpression[] expressions;
        
        /** Whether the media query condition is satisfied. */
        public final boolean active;
        
        /**
         * Constructor
         *
         * @param expressions Array of media query expressions.
         * 
         * @param active Whether the media query condition is satisfied.
         */
        public MediaQuery(CSS.MediaQueryExpression[] expressions, boolean active)
        {
            // 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 (expressions == null) BRDPC.throwNPE("expressions");
            
            this.expressions  = expressions;
            this.active       = active;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'MediaQuery'}.
         */
        public MediaQuery (JsonObject jo)
        {
            this.expressions = (jo.getJsonArray("expressions") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("expressions"), null, 0, CSS.MediaQueryExpression[].class);
        
            this.active       = ReadPrimJSON.getBoolean(jo, "active");
        }
        
        
        /** 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;
        
            MediaQuery o = (MediaQuery) other;
        
            return
                    Arrays.deepEquals(this.expressions, o.expressions)
                &&  (this.active == o.active);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Arrays.deepHashCode(this.expressions)
                +   (this.active ? 1 : 0);
        }
    }
    
    /** Media query expression descriptor. */
    public static class MediaQueryExpression
        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, false, true, true, }; }
        
        /** Media query expression value. */
        public final Number value;
        
        /** Media query expression units. */
        public final String unit;
        
        /** Media query expression feature. */
        public final String feature;
        
        /**
         * The associated range of the value text in the enclosing stylesheet (if available).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final CSS.SourceRange valueRange;
        
        /**
         * Computed length of media query expression (if applicable).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Number computedLength;
        
        /**
         * Constructor
         *
         * @param value Media query expression value.
         * 
         * @param unit Media query expression units.
         * 
         * @param feature Media query expression feature.
         * 
         * @param valueRange The associated range of the value text in the enclosing stylesheet (if available).
         * <BR /><B>OPTIONAL</B>
         * 
         * @param computedLength Computed length of media query expression (if applicable).
         * <BR /><B>OPTIONAL</B>
         */
        public MediaQueryExpression(
                Number value, String unit, String feature, CSS.SourceRange valueRange, 
                Number computedLength
            )
        {
            // 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 (value == null)   BRDPC.throwNPE("value");
            if (unit == null)    BRDPC.throwNPE("unit");
            if (feature == null) BRDPC.throwNPE("feature");
            
            this.value           = value;
            this.unit            = unit;
            this.feature         = feature;
            this.valueRange      = valueRange;
            this.computedLength  = computedLength;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'MediaQueryExpression'}.
         */
        public MediaQueryExpression (JsonObject jo)
        {
            this.value           = ReadNumberJSON.get(jo, "value", false, true);
            this.unit            = ReadJSON.getString(jo, "unit", false, true);
            this.feature         = ReadJSON.getString(jo, "feature", false, true);
            this.valueRange      = ReadJSON.getObject(jo, "valueRange", CSS.SourceRange.class, true, false);
            this.computedLength  = ReadNumberJSON.get(jo, "computedLength", 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;
        
            MediaQueryExpression o = (MediaQueryExpression) other;
        
            return
                    Objects.equals(this.value, o.value)
                &&  Objects.equals(this.unit, o.unit)
                &&  Objects.equals(this.feature, o.feature)
                &&  Objects.equals(this.valueRange, o.valueRange)
                &&  Objects.equals(this.computedLength, o.computedLength);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.value)
                +   Objects.hashCode(this.unit)
                +   Objects.hashCode(this.feature)
                +   this.valueRange.hashCode()
                +   Objects.hashCode(this.computedLength);
        }
    }
    
    /**
     * CSS container query rule descriptor.
     * <BR />
     * <BR /><B>EXPERIMENTAL</B>
     */
    public static class CSSContainerQuery
        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, true, true, }; }
        
        /** Container query text. */
        public final String text;
        
        /**
         * The associated rule header range in the enclosing stylesheet (if
         * available).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final CSS.SourceRange range;
        
        /**
         * Identifier of the stylesheet containing this object (if exists).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String styleSheetId;
        
        /**
         * Optional name for the container.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String name;
        
        /**
         * Constructor
         *
         * @param text Container query text.
         * 
         * @param range 
         * The associated rule header range in the enclosing stylesheet (if
         * available).
         * <BR /><B>OPTIONAL</B>
         * 
         * @param styleSheetId Identifier of the stylesheet containing this object (if exists).
         * <BR /><B>OPTIONAL</B>
         * 
         * @param name Optional name for the container.
         * <BR /><B>OPTIONAL</B>
         */
        public CSSContainerQuery
            (String text, CSS.SourceRange range, String styleSheetId, String name)
        {
            // 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");
            
            this.text          = text;
            this.range         = range;
            this.styleSheetId  = styleSheetId;
            this.name          = name;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'CSSContainerQuery'}.
         */
        public CSSContainerQuery (JsonObject jo)
        {
            this.text          = ReadJSON.getString(jo, "text", false, true);
            this.range         = ReadJSON.getObject(jo, "range", CSS.SourceRange.class, true, false);
            this.styleSheetId  = ReadJSON.getString(jo, "styleSheetId", true, false);
            this.name          = ReadJSON.getString(jo, "name", 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;
        
            CSSContainerQuery o = (CSSContainerQuery) other;
        
            return
                    Objects.equals(this.text, o.text)
                &&  Objects.equals(this.range, o.range)
                &&  Objects.equals(this.styleSheetId, o.styleSheetId)
                &&  Objects.equals(this.name, o.name);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.text)
                +   this.range.hashCode()
                +   Objects.hashCode(this.styleSheetId)
                +   Objects.hashCode(this.name);
        }
    }
    
    /** Information about amount of glyphs that were rendered with given font. */
    public static class PlatformFontUsage
        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, false, }; }
        
        /** Font's family name reported by platform. */
        public final String familyName;
        
        /** Indicates if the font was downloaded or resolved locally. */
        public final boolean isCustomFont;
        
        /** Amount of glyphs that were rendered with this font. */
        public final Number glyphCount;
        
        /**
         * Constructor
         *
         * @param familyName Font's family name reported by platform.
         * 
         * @param isCustomFont Indicates if the font was downloaded or resolved locally.
         * 
         * @param glyphCount Amount of glyphs that were rendered with this font.
         */
        public PlatformFontUsage(String familyName, boolean isCustomFont, Number glyphCount)
        {
            // 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 (familyName == null) BRDPC.throwNPE("familyName");
            if (glyphCount == null) BRDPC.throwNPE("glyphCount");
            
            this.familyName    = familyName;
            this.isCustomFont  = isCustomFont;
            this.glyphCount    = glyphCount;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'PlatformFontUsage'}.
         */
        public PlatformFontUsage (JsonObject jo)
        {
            this.familyName    = ReadJSON.getString(jo, "familyName", false, true);
            this.isCustomFont  = ReadPrimJSON.getBoolean(jo, "isCustomFont");
            this.glyphCount    = ReadNumberJSON.get(jo, "glyphCount", 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;
        
            PlatformFontUsage o = (PlatformFontUsage) other;
        
            return
                    Objects.equals(this.familyName, o.familyName)
                &&  (this.isCustomFont == o.isCustomFont)
                &&  Objects.equals(this.glyphCount, o.glyphCount);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.familyName)
                +   (this.isCustomFont ? 1 : 0)
                +   Objects.hashCode(this.glyphCount);
        }
    }
    
    /** Information about font variation axes for variable fonts */
    public static class FontVariationAxis
        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, false, false, false, }; }
        
        /** The font-variation-setting tag (a.k.a. "axis tag"). */
        public final String tag;
        
        /** Human-readable variation name in the default language (normally, "en"). */
        public final String name;
        
        /** The minimum value (inclusive) the font supports for this tag. */
        public final Number minValue;
        
        /** The maximum value (inclusive) the font supports for this tag. */
        public final Number maxValue;
        
        /** The default value. */
        public final Number defaultValue;
        
        /**
         * Constructor
         *
         * @param tag The font-variation-setting tag (a.k.a. "axis tag").
         * 
         * @param name Human-readable variation name in the default language (normally, "en").
         * 
         * @param minValue The minimum value (inclusive) the font supports for this tag.
         * 
         * @param maxValue The maximum value (inclusive) the font supports for this tag.
         * 
         * @param defaultValue The default value.
         */
        public FontVariationAxis
            (String tag, String name, Number minValue, Number maxValue, Number defaultValue)
        {
            // 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 (tag == null)          BRDPC.throwNPE("tag");
            if (name == null)         BRDPC.throwNPE("name");
            if (minValue == null)     BRDPC.throwNPE("minValue");
            if (maxValue == null)     BRDPC.throwNPE("maxValue");
            if (defaultValue == null) BRDPC.throwNPE("defaultValue");
            
            this.tag           = tag;
            this.name          = name;
            this.minValue      = minValue;
            this.maxValue      = maxValue;
            this.defaultValue  = defaultValue;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'FontVariationAxis'}.
         */
        public FontVariationAxis (JsonObject jo)
        {
            this.tag           = ReadJSON.getString(jo, "tag", false, true);
            this.name          = ReadJSON.getString(jo, "name", false, true);
            this.minValue      = ReadNumberJSON.get(jo, "minValue", false, true);
            this.maxValue      = ReadNumberJSON.get(jo, "maxValue", false, true);
            this.defaultValue  = ReadNumberJSON.get(jo, "defaultValue", 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;
        
            FontVariationAxis o = (FontVariationAxis) other;
        
            return
                    Objects.equals(this.tag, o.tag)
                &&  Objects.equals(this.name, o.name)
                &&  Objects.equals(this.minValue, o.minValue)
                &&  Objects.equals(this.maxValue, o.maxValue)
                &&  Objects.equals(this.defaultValue, o.defaultValue);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.tag)
                +   Objects.hashCode(this.name)
                +   Objects.hashCode(this.minValue)
                +   Objects.hashCode(this.maxValue)
                +   Objects.hashCode(this.defaultValue);
        }
    }
    
    /**
     * Properties of a web font: https://www.w3.org/TR/2008/REC-CSS2-20080411/fonts.html#font-descriptions
     * and additional information such as platformFontFamily and fontVariationAxes.
     */
    public static class FontFace
        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, false, false, false, false, false, false, true, }; }
        
        /** The font-family. */
        public final String fontFamily;
        
        /** The font-style. */
        public final String fontStyle;
        
        /** The font-variant. */
        public final String fontVariant;
        
        /** The font-weight. */
        public final String fontWeight;
        
        /** The font-stretch. */
        public final String fontStretch;
        
        /** The unicode-range. */
        public final String unicodeRange;
        
        /** The src. */
        public final String src;
        
        /** The resolved platform font family */
        public final String platformFontFamily;
        
        /**
         * Available variation settings (a.k.a. "axes").
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final CSS.FontVariationAxis[] fontVariationAxes;
        
        /**
         * Constructor
         *
         * @param fontFamily The font-family.
         * 
         * @param fontStyle The font-style.
         * 
         * @param fontVariant The font-variant.
         * 
         * @param fontWeight The font-weight.
         * 
         * @param fontStretch The font-stretch.
         * 
         * @param unicodeRange The unicode-range.
         * 
         * @param src The src.
         * 
         * @param platformFontFamily The resolved platform font family
         * 
         * @param fontVariationAxes Available variation settings (a.k.a. "axes").
         * <BR /><B>OPTIONAL</B>
         */
        public FontFace(
                String fontFamily, String fontStyle, String fontVariant, String fontWeight, 
                String fontStretch, String unicodeRange, String src, String platformFontFamily, 
                CSS.FontVariationAxis[] fontVariationAxes
            )
        {
            // 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 (fontFamily == null)         BRDPC.throwNPE("fontFamily");
            if (fontStyle == null)          BRDPC.throwNPE("fontStyle");
            if (fontVariant == null)        BRDPC.throwNPE("fontVariant");
            if (fontWeight == null)         BRDPC.throwNPE("fontWeight");
            if (fontStretch == null)        BRDPC.throwNPE("fontStretch");
            if (unicodeRange == null)       BRDPC.throwNPE("unicodeRange");
            if (src == null)                BRDPC.throwNPE("src");
            if (platformFontFamily == null) BRDPC.throwNPE("platformFontFamily");
            
            this.fontFamily          = fontFamily;
            this.fontStyle           = fontStyle;
            this.fontVariant         = fontVariant;
            this.fontWeight          = fontWeight;
            this.fontStretch         = fontStretch;
            this.unicodeRange        = unicodeRange;
            this.src                 = src;
            this.platformFontFamily  = platformFontFamily;
            this.fontVariationAxes   = fontVariationAxes;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'FontFace'}.
         */
        public FontFace (JsonObject jo)
        {
            this.fontFamily          = ReadJSON.getString(jo, "fontFamily", false, true);
            this.fontStyle           = ReadJSON.getString(jo, "fontStyle", false, true);
            this.fontVariant         = ReadJSON.getString(jo, "fontVariant", false, true);
            this.fontWeight          = ReadJSON.getString(jo, "fontWeight", false, true);
            this.fontStretch         = ReadJSON.getString(jo, "fontStretch", false, true);
            this.unicodeRange        = ReadJSON.getString(jo, "unicodeRange", false, true);
            this.src                 = ReadJSON.getString(jo, "src", false, true);
            this.platformFontFamily  = ReadJSON.getString(jo, "platformFontFamily", false, true);
            this.fontVariationAxes = (jo.getJsonArray("fontVariationAxes") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("fontVariationAxes"), null, 0, CSS.FontVariationAxis[].class);
        
        }
        
        
        /** 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;
        
            FontFace o = (FontFace) other;
        
            return
                    Objects.equals(this.fontFamily, o.fontFamily)
                &&  Objects.equals(this.fontStyle, o.fontStyle)
                &&  Objects.equals(this.fontVariant, o.fontVariant)
                &&  Objects.equals(this.fontWeight, o.fontWeight)
                &&  Objects.equals(this.fontStretch, o.fontStretch)
                &&  Objects.equals(this.unicodeRange, o.unicodeRange)
                &&  Objects.equals(this.src, o.src)
                &&  Objects.equals(this.platformFontFamily, o.platformFontFamily)
                &&  Arrays.deepEquals(this.fontVariationAxes, o.fontVariationAxes);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.fontFamily)
                +   Objects.hashCode(this.fontStyle)
                +   Objects.hashCode(this.fontVariant)
                +   Objects.hashCode(this.fontWeight)
                +   Objects.hashCode(this.fontStretch)
                +   Objects.hashCode(this.unicodeRange)
                +   Objects.hashCode(this.src)
                +   Objects.hashCode(this.platformFontFamily)
                +   Arrays.deepHashCode(this.fontVariationAxes);
        }
    }
    
    /** CSS keyframes rule representation. */
    public static class CSSKeyframesRule
        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, }; }
        
        /** Animation name. */
        public final CSS.Value animationName;
        
        /** List of keyframes. */
        public final CSS.CSSKeyframeRule[] keyframes;
        
        /**
         * Constructor
         *
         * @param animationName Animation name.
         * 
         * @param keyframes List of keyframes.
         */
        public CSSKeyframesRule(CSS.Value animationName, CSS.CSSKeyframeRule[] keyframes)
        {
            // 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 (animationName == null) BRDPC.throwNPE("animationName");
            if (keyframes == null)     BRDPC.throwNPE("keyframes");
            
            this.animationName  = animationName;
            this.keyframes      = keyframes;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'CSSKeyframesRule'}.
         */
        public CSSKeyframesRule (JsonObject jo)
        {
            this.animationName  = ReadJSON.getObject(jo, "animationName", CSS.Value.class, false, true);
            this.keyframes = (jo.getJsonArray("keyframes") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("keyframes"), null, 0, CSS.CSSKeyframeRule[].class);
        
        }
        
        
        /** 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;
        
            CSSKeyframesRule o = (CSSKeyframesRule) other;
        
            return
                    Objects.equals(this.animationName, o.animationName)
                &&  Arrays.deepEquals(this.keyframes, o.keyframes);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.animationName.hashCode()
                +   Arrays.deepHashCode(this.keyframes);
        }
    }
    
    /** CSS keyframe rule representation. */
    public static class CSSKeyframeRule
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { true, false, false, false, }; }
        
        /**
         * The css style sheet identifier (absent for user agent stylesheet and user-specified
         * stylesheet rules) this rule came from.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String styleSheetId;
        
        /** Parent stylesheet's origin. */
        public final String origin;
        
        /** Associated key text. */
        public final CSS.Value keyText;
        
        /** Associated style declaration. */
        public final CSS.CSSStyle style;
        
        /**
         * Constructor
         *
         * @param styleSheetId 
         * The css style sheet identifier (absent for user agent stylesheet and user-specified
         * stylesheet rules) this rule came from.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param origin Parent stylesheet's origin.
         * 
         * @param keyText Associated key text.
         * 
         * @param style Associated style declaration.
         */
        public CSSKeyframeRule
            (String styleSheetId, String origin, CSS.Value keyText, CSS.CSSStyle style)
        {
            // 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 (origin == null)  BRDPC.throwNPE("origin");
            if (keyText == null) BRDPC.throwNPE("keyText");
            if (style == null)   BRDPC.throwNPE("style");
            
            // 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("origin", origin, "CSS.StyleSheetOrigin", CSS.StyleSheetOrigin);
            
            this.styleSheetId  = styleSheetId;
            this.origin        = origin;
            this.keyText       = keyText;
            this.style         = style;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'CSSKeyframeRule'}.
         */
        public CSSKeyframeRule (JsonObject jo)
        {
            this.styleSheetId  = ReadJSON.getString(jo, "styleSheetId", true, false);
            this.origin        = ReadJSON.getString(jo, "origin", false, true);
            this.keyText       = ReadJSON.getObject(jo, "keyText", CSS.Value.class, false, true);
            this.style         = ReadJSON.getObject(jo, "style", CSS.CSSStyle.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;
        
            CSSKeyframeRule o = (CSSKeyframeRule) other;
        
            return
                    Objects.equals(this.styleSheetId, o.styleSheetId)
                &&  Objects.equals(this.origin, o.origin)
                &&  Objects.equals(this.keyText, o.keyText)
                &&  Objects.equals(this.style, o.style);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.styleSheetId)
                +   Objects.hashCode(this.origin)
                +   this.keyText.hashCode()
                +   this.style.hashCode();
        }
    }
    
    /** A descriptor of operation to mutate style declaration text. */
    public static class StyleDeclarationEdit
        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, false, }; }
        
        /** The css style sheet identifier. */
        public final String styleSheetId;
        
        /** The range of the style text in the enclosing stylesheet. */
        public final CSS.SourceRange range;
        
        /** New style text. */
        public final String text;
        
        /**
         * Constructor
         *
         * @param styleSheetId The css style sheet identifier.
         * 
         * @param range The range of the style text in the enclosing stylesheet.
         * 
         * @param text New style text.
         */
        public StyleDeclarationEdit(String styleSheetId, CSS.SourceRange range, 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 (styleSheetId == null) BRDPC.throwNPE("styleSheetId");
            if (range == null)        BRDPC.throwNPE("range");
            if (text == null)         BRDPC.throwNPE("text");
            
            this.styleSheetId  = styleSheetId;
            this.range         = range;
            this.text          = text;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'StyleDeclarationEdit'}.
         */
        public StyleDeclarationEdit (JsonObject jo)
        {
            this.styleSheetId  = ReadJSON.getString(jo, "styleSheetId", false, true);
            this.range         = ReadJSON.getObject(jo, "range", CSS.SourceRange.class, false, true);
            this.text          = ReadJSON.getString(jo, "text", 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;
        
            StyleDeclarationEdit o = (StyleDeclarationEdit) other;
        
            return
                    Objects.equals(this.styleSheetId, o.styleSheetId)
                &&  Objects.equals(this.range, o.range)
                &&  Objects.equals(this.text, o.text);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.styleSheetId)
                +   this.range.hashCode()
                +   Objects.hashCode(this.text);
        }
    }
    
    /**
     * Fires whenever a MediaQuery result changes (for example, after a browser window has been
     * resized.) The current implementation considers only viewport-dependent media features.
     *
     * <BR /><BR />This is Marker-Event.  Marker-Event's are Events that do not posses
     * any data, fields or state.  When they are fired, only the event name is supplied.
     */
    public static class mediaQueryResultChanged
        extends BrowserEvent
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
    
        public boolean[] optionals() { return new boolean[0]; }
    
        /** JSON Object Constructor */
        public mediaQueryResultChanged(JsonObject jo)
        { super("CSS", "mediaQueryResultChanged", 0); }
    
        @Override
        public String toString() { return "CSS.mediaQueryResultChanged Marker Event\n"; }
    }
    
    /**
     * Fires whenever a web font is updated.  A non-empty font parameter indicates a successfully loaded
     * web font
     */
    public static class fontsUpdated
        extends BrowserEvent
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { true, }; }
        
        /**
         * The web font that has loaded.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final CSS.FontFace font;
        
        /**
         * Constructor
         *
         * @param font The web font that has loaded.
         * <BR /><B>OPTIONAL</B>
         */
        public fontsUpdated(CSS.FontFace font)
        {
            super("CSS", "fontsUpdated", 1);
            
            this.font  = font;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'fontsUpdated'}.
         */
        public fontsUpdated (JsonObject jo)
        {
            super("CSS", "fontsUpdated", 1);
        
            this.font  = ReadJSON.getObject(jo, "font", CSS.FontFace.class, 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;
        
            fontsUpdated o = (fontsUpdated) other;
        
            return
                    Objects.equals(this.font, o.font);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.font.hashCode();
        }
    }
    
    /** Fired whenever an active document stylesheet is added. */
    public static class styleSheetAdded
        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, }; }
        
        /** Added stylesheet metainfo. */
        public final CSS.CSSStyleSheetHeader header;
        
        /**
         * Constructor
         *
         * @param header Added stylesheet metainfo.
         */
        public styleSheetAdded(CSS.CSSStyleSheetHeader header)
        {
            super("CSS", "styleSheetAdded", 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 (header == null) BRDPC.throwNPE("header");
            
            this.header  = header;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'styleSheetAdded'}.
         */
        public styleSheetAdded (JsonObject jo)
        {
            super("CSS", "styleSheetAdded", 1);
        
            this.header  = ReadJSON.getObject(jo, "header", CSS.CSSStyleSheetHeader.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;
        
            styleSheetAdded o = (styleSheetAdded) other;
        
            return
                    Objects.equals(this.header, o.header);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.header.hashCode();
        }
    }
    
    /** Fired whenever a stylesheet is changed as a result of the client operation. */
    public static class styleSheetChanged
        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 String styleSheetId;
        
        /**
         * Constructor
         *
         * @param styleSheetId -
         */
        public styleSheetChanged(String styleSheetId)
        {
            super("CSS", "styleSheetChanged", 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 (styleSheetId == null) BRDPC.throwNPE("styleSheetId");
            
            this.styleSheetId  = styleSheetId;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'styleSheetChanged'}.
         */
        public styleSheetChanged (JsonObject jo)
        {
            super("CSS", "styleSheetChanged", 1);
        
            this.styleSheetId  = ReadJSON.getString(jo, "styleSheetId", 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;
        
            styleSheetChanged o = (styleSheetChanged) other;
        
            return
                    Objects.equals(this.styleSheetId, o.styleSheetId);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.styleSheetId);
        }
    }
    
    /** Fired whenever an active document stylesheet is removed. */
    public static class styleSheetRemoved
        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, }; }
        
        /** Identifier of the removed stylesheet. */
        public final String styleSheetId;
        
        /**
         * Constructor
         *
         * @param styleSheetId Identifier of the removed stylesheet.
         */
        public styleSheetRemoved(String styleSheetId)
        {
            super("CSS", "styleSheetRemoved", 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 (styleSheetId == null) BRDPC.throwNPE("styleSheetId");
            
            this.styleSheetId  = styleSheetId;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'styleSheetRemoved'}.
         */
        public styleSheetRemoved (JsonObject jo)
        {
            super("CSS", "styleSheetRemoved", 1);
        
            this.styleSheetId  = ReadJSON.getString(jo, "styleSheetId", 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;
        
            styleSheetRemoved o = (styleSheetRemoved) other;
        
            return
                    Objects.equals(this.styleSheetId, o.styleSheetId);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.styleSheetId);
        }
    }
    
    
    // Counter for keeping the WebSocket Request ID's distinct.
    private static int counter = 1;
    
    /**
     * Inserts a new rule with the given <CODE>ruleText</CODE> in a stylesheet with given <CODE>styleSheetId</CODE>, at the
     * position specified by <CODE>location</CODE>.
     * 
     * @param styleSheetId The css style sheet identifier where a new rule should be inserted.
     * 
     * @param ruleText The text of a new rule.
     * 
     * @param location Text position of a new rule in the target style sheet.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link CSS.CSSRule}&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * {@link CSS.CSSRule}&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>{@link CSS.CSSRule} (<B>rule</B></CODE>)
     *     <BR />The newly created rule.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, CSS.CSSRule> addRule
        (String styleSheetId, String ruleText, CSS.SourceRange location)
    {
        // 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 (styleSheetId == null) BRDPC.throwNPE("styleSheetId");
        if (ruleText == null)     BRDPC.throwNPE("ruleText");
        if (location == null)     BRDPC.throwNPE("location");
        
        final int       webSocketID = 12000000 + counter++;
        final boolean[] optionals   = { false, false, false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("addRule"),
            parameterNames.get("addRule"),
            optionals, webSocketID,
            "CSS.addRule",
            styleSheetId, ruleText, location
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'CSS.CSSRule'
        Function<JsonObject, CSS.CSSRule> responseProcessor = (JsonObject jo) ->
            ReadJSON.getObject(jo, "rule", CSS.CSSRule.class, false, true);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Returns all class names from specified stylesheet.
     * 
     * @param styleSheetId -
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * String[]&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * String[]&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>String[] (<B>classNames</B></CODE>)
     *     <BR />Class name list.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, String[]> collectClassNames(String styleSheetId)
    {
        // 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 (styleSheetId == null) BRDPC.throwNPE("styleSheetId");
        
        final int       webSocketID = 12001000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("collectClassNames"),
            parameterNames.get("collectClassNames"),
            optionals, webSocketID,
            "CSS.collectClassNames",
            styleSheetId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'String[]'
        Function<JsonObject, String[]> responseProcessor = (JsonObject jo) ->
            (jo.getJsonArray("classNames") == null)
                ? null
                : ReadArrJSON.DimN.strArr(jo.getJsonArray("classNames"), null, 0, String[].class);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Creates a new special "via-inspector" stylesheet in the frame with given <CODE>frameId</CODE>.
     * 
     * @param frameId Identifier of the frame where "via-inspector" stylesheet should be created.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * String&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * String&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>String (<B>styleSheetId</B></CODE>)
     *     <BR />Identifier of the created "via-inspector" stylesheet.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, String> createStyleSheet(String frameId)
    {
        // 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 (frameId == null) BRDPC.throwNPE("frameId");
        
        final int       webSocketID = 12002000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("createStyleSheet"),
            parameterNames.get("createStyleSheet"),
            optionals, webSocketID,
            "CSS.createStyleSheet",
            frameId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'String'
        Function<JsonObject, String> responseProcessor = (JsonObject jo) ->
            ReadJSON.getString(jo, "styleSheetId", false, true);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Disables the CSS agent for the given page.
     * 
     * @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> disable()
    {
        final int          webSocketID = 12003000 + counter++;
        final boolean[]    optionals   = new boolean[0];
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("disable"),
            parameterNames.get("disable"),
            optionals, webSocketID,
            "CSS.disable"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Enables the CSS agent for the given page. Clients should not assume that the CSS agent has been
     * enabled until the result of this command is received.
     * 
     * @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> enable()
    {
        final int          webSocketID = 12004000 + counter++;
        final boolean[]    optionals   = new boolean[0];
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("enable"),
            parameterNames.get("enable"),
            optionals, webSocketID,
            "CSS.enable"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Ensures that the given node will have specified pseudo-classes whenever its style is computed by
     * the browser.
     * 
     * @param nodeId The element id for which to force the pseudo state.
     * 
     * @param forcedPseudoClasses Element pseudo classes to force when computing the element's style.
     * 
     * @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> forcePseudoState
        (int nodeId, String[] forcedPseudoClasses)
    {
        // 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 (forcedPseudoClasses == null) BRDPC.throwNPE("forcedPseudoClasses");
        
        final int       webSocketID = 12005000 + counter++;
        final boolean[] optionals   = { false, false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("forcePseudoState"),
            parameterNames.get("forcePseudoState"),
            optionals, webSocketID,
            "CSS.forcePseudoState",
            nodeId, forcedPseudoClasses
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * 
     * @param nodeId Id of the node to get background colors for.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret3}&gt;</CODE>
     *
     * <BR /><BR />This {@link Script} may be <B STYLE='color:red'>executed</B> (using 
     * {@link Script#exec()}), and a {@link Promise} returned.
     *
     * <BR /><BR />When the {@code Promise} is <B STYLE='color: red'>awaited</B>
     * (using {@link Promise#await()}), the {@code Ret3} will subsequently
     * be returned from that call.
     * 
     * <BR /><BR />The <B STYLE='color: red'>returned</B> values are encapsulated
     * in an instance of <B>{@link Ret3}</B>
     *
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE><B>Ret3.a:</B> String[] (<B>backgroundColors</B>)</CODE>
     *     <BR />The range of background colors behind this element, if it contains any visible text. If no
     *     visible text is present, this will be undefined. In the case of a flat background color,
     *     this will consist of simply that color. In the case of a gradient, this will consist of each
     *     of the color stops. For anything more complicated, this will be an empty array. Images will
     *     be ignored (as if the image had failed to load).
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret3.b:</B> String (<B>computedFontSize</B>)</CODE>
     *     <BR />The computed font size for this node, as a CSS computed value string (e.g. '12px').
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret3.c:</B> String (<B>computedFontWeight</B>)</CODE>
     *     <BR />The computed font weight for this node, as a CSS computed value string (e.g. 'normal' or
     *     '100').
     *     </LI>
     * </UL>
     */
    public static Script<String, JsonObject, Ret3<String[], String, String>> getBackgroundColors
        (int nodeId)
    {
        final int       webSocketID = 12006000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getBackgroundColors"),
            parameterNames.get("getBackgroundColors"),
            optionals, webSocketID,
            "CSS.getBackgroundColors",
            nodeId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON into Java-Type 'Ret3'
        Function<JsonObject, Ret3<String[], String, String>> 
            responseProcessor = (JsonObject jo) -> new Ret3<>(
                (jo.getJsonArray("backgroundColors") == null)
                    ? null
                    : ReadArrJSON.DimN.strArr(jo.getJsonArray("backgroundColors"), null, 0, String[].class),
                ReadJSON.getString(jo, "computedFontSize", true, false),
                ReadJSON.getString(jo, "computedFontWeight", true, false)
            );
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Returns the computed style for a DOM node identified by <CODE>nodeId</CODE>.
     * 
     * @param nodeId -
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link CSS.CSSComputedStyleProperty}[]&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * {@link CSS.CSSComputedStyleProperty}[]&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>{@link CSS.CSSComputedStyleProperty}[] (<B>computedStyle</B></CODE>)
     *     <BR />Computed style for the specified DOM node.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, CSS.CSSComputedStyleProperty[]> getComputedStyleForNode
        (int nodeId)
    {
        final int       webSocketID = 12007000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getComputedStyleForNode"),
            parameterNames.get("getComputedStyleForNode"),
            optionals, webSocketID,
            "CSS.getComputedStyleForNode",
            nodeId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'CSS.CSSComputedStyleProperty[]'
        Function<JsonObject, CSS.CSSComputedStyleProperty[]> responseProcessor = (JsonObject jo) ->
            (jo.getJsonArray("computedStyle") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("computedStyle"), null, 0, CSS.CSSComputedStyleProperty[].class);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Returns the styles defined inline (explicitly in the "style" attribute and implicitly, using DOM
     * attributes) for a DOM node identified by <CODE>nodeId</CODE>.
     * 
     * @param nodeId -
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret2}&gt;</CODE>
     *
     * <BR /><BR />This {@link Script} may be <B STYLE='color:red'>executed</B> (using 
     * {@link Script#exec()}), and a {@link Promise} returned.
     *
     * <BR /><BR />When the {@code Promise} is <B STYLE='color: red'>awaited</B>
     * (using {@link Promise#await()}), the {@code Ret2} will subsequently
     * be returned from that call.
     * 
     * <BR /><BR />The <B STYLE='color: red'>returned</B> values are encapsulated
     * in an instance of <B>{@link Ret2}</B>
     *
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE><B>Ret2.a:</B> {@link CSS.CSSStyle} (<B>inlineStyle</B>)</CODE>
     *     <BR />Inline style for the specified DOM node.
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret2.b:</B> {@link CSS.CSSStyle} (<B>attributesStyle</B>)</CODE>
     *     <BR />Attribute-defined element style (e.g. resulting from "width=20 height=100%").
     *     </LI>
     * </UL>
     */
    public static Script<String, JsonObject, Ret2<CSS.CSSStyle, CSS.CSSStyle>> getInlineStylesForNode
        (int nodeId)
    {
        final int       webSocketID = 12008000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getInlineStylesForNode"),
            parameterNames.get("getInlineStylesForNode"),
            optionals, webSocketID,
            "CSS.getInlineStylesForNode",
            nodeId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON into Java-Type 'Ret2'
        Function<JsonObject, Ret2<CSS.CSSStyle, CSS.CSSStyle>> 
            responseProcessor = (JsonObject jo) -> new Ret2<>(
                ReadJSON.getObject(jo, "inlineStyle", CSS.CSSStyle.class, true, false),
                ReadJSON.getObject(jo, "attributesStyle", CSS.CSSStyle.class, true, false)
            );
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Returns requested styles for a DOM node identified by <CODE>nodeId</CODE>.
     * 
     * @param nodeId -
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret6}&gt;</CODE>
     *
     * <BR /><BR />This {@link Script} may be <B STYLE='color:red'>executed</B> (using 
     * {@link Script#exec()}), and a {@link Promise} returned.
     *
     * <BR /><BR />When the {@code Promise} is <B STYLE='color: red'>awaited</B>
     * (using {@link Promise#await()}), the {@code Ret6} will subsequently
     * be returned from that call.
     * 
     * <BR /><BR />The <B STYLE='color: red'>returned</B> values are encapsulated
     * in an instance of <B>{@link Ret6}</B>
     *
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE><B>Ret6.a1:</B> {@link CSS.CSSStyle} (<B>inlineStyle</B>)</CODE>
     *     <BR />Inline style for the specified DOM node.
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret6.b2:</B> {@link CSS.CSSStyle} (<B>attributesStyle</B>)</CODE>
     *     <BR />Attribute-defined element style (e.g. resulting from "width=20 height=100%").
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret6.c3:</B> {@link CSS.RuleMatch}[] (<B>matchedCSSRules</B>)</CODE>
     *     <BR />CSS rules matching this node, from all applicable stylesheets.
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret6.d4:</B> {@link CSS.PseudoElementMatches}[] (<B>pseudoElements</B>)</CODE>
     *     <BR />Pseudo style matches for this node.
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret6.e5:</B> {@link CSS.InheritedStyleEntry}[] (<B>inherited</B>)</CODE>
     *     <BR />A chain of inherited styles (from the immediate node parent up to the DOM tree root).
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret6.f6:</B> {@link CSS.CSSKeyframesRule}[] (<B>cssKeyframesRules</B>)</CODE>
     *     <BR />A list of CSS keyframed animations matching this node.
     *     </LI>
     * </UL>
     */
    public static Script<String, JsonObject, Ret6<CSS.CSSStyle, CSS.CSSStyle, CSS.RuleMatch[], CSS.PseudoElementMatches[], CSS.InheritedStyleEntry[], CSS.CSSKeyframesRule[]>> 
        getMatchedStylesForNode(int nodeId)
    {
        final int       webSocketID = 12009000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getMatchedStylesForNode"),
            parameterNames.get("getMatchedStylesForNode"),
            optionals, webSocketID,
            "CSS.getMatchedStylesForNode",
            nodeId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON into Java-Type 'Ret6'
        Function<JsonObject, Ret6<CSS.CSSStyle, CSS.CSSStyle, CSS.RuleMatch[], CSS.PseudoElementMatches[], CSS.InheritedStyleEntry[], CSS.CSSKeyframesRule[]>> 
            responseProcessor = (JsonObject jo) -> new Ret6<>(
                ReadJSON.getObject(jo, "inlineStyle", CSS.CSSStyle.class, true, false),
                ReadJSON.getObject(jo, "attributesStyle", CSS.CSSStyle.class, true, false),
                (jo.getJsonArray("matchedCSSRules") == null)
                    ? null
                    : ReadArrJSON.DimN.objArr(jo.getJsonArray("matchedCSSRules"), null, 0, CSS.RuleMatch[].class),
                (jo.getJsonArray("pseudoElements") == null)
                    ? null
                    : ReadArrJSON.DimN.objArr(jo.getJsonArray("pseudoElements"), null, 0, CSS.PseudoElementMatches[].class),
                (jo.getJsonArray("inherited") == null)
                    ? null
                    : ReadArrJSON.DimN.objArr(jo.getJsonArray("inherited"), null, 0, CSS.InheritedStyleEntry[].class),
                (jo.getJsonArray("cssKeyframesRules") == null)
                    ? null
                    : ReadArrJSON.DimN.objArr(jo.getJsonArray("cssKeyframesRules"), null, 0, CSS.CSSKeyframesRule[].class)
            );
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Returns all media queries parsed by the rendering engine.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link CSS.CSSMedia}[]&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * {@link CSS.CSSMedia}[]&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>{@link CSS.CSSMedia}[] (<B>medias</B></CODE>)
     *     <BR />-
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, CSS.CSSMedia[]> getMediaQueries()
    {
        final int          webSocketID = 12010000 + counter++;
        final boolean[]    optionals   = new boolean[0];
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getMediaQueries"),
            parameterNames.get("getMediaQueries"),
            optionals, webSocketID,
            "CSS.getMediaQueries"
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'CSS.CSSMedia[]'
        Function<JsonObject, CSS.CSSMedia[]> responseProcessor = (JsonObject jo) ->
            (jo.getJsonArray("medias") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("medias"), null, 0, CSS.CSSMedia[].class);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Requests information about platform fonts which we used to render child TextNodes in the given
     * node.
     * 
     * @param nodeId -
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link CSS.PlatformFontUsage}[]&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * {@link CSS.PlatformFontUsage}[]&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>{@link CSS.PlatformFontUsage}[] (<B>fonts</B></CODE>)
     *     <BR />Usage statistics for every employed platform font.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, CSS.PlatformFontUsage[]> getPlatformFontsForNode
        (int nodeId)
    {
        final int       webSocketID = 12011000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getPlatformFontsForNode"),
            parameterNames.get("getPlatformFontsForNode"),
            optionals, webSocketID,
            "CSS.getPlatformFontsForNode",
            nodeId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'CSS.PlatformFontUsage[]'
        Function<JsonObject, CSS.PlatformFontUsage[]> responseProcessor = (JsonObject jo) ->
            (jo.getJsonArray("fonts") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("fonts"), null, 0, CSS.PlatformFontUsage[].class);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Returns the current textual content for a stylesheet.
     * 
     * @param styleSheetId -
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * String&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * String&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>String (<B>text</B></CODE>)
     *     <BR />The stylesheet text.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, String> getStyleSheetText(String styleSheetId)
    {
        // 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 (styleSheetId == null) BRDPC.throwNPE("styleSheetId");
        
        final int       webSocketID = 12012000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getStyleSheetText"),
            parameterNames.get("getStyleSheetText"),
            optionals, webSocketID,
            "CSS.getStyleSheetText",
            styleSheetId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'String'
        Function<JsonObject, String> responseProcessor = (JsonObject jo) ->
            ReadJSON.getString(jo, "text", false, true);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Starts tracking the given computed styles for updates. The specified array of properties
     * replaces the one previously specified. Pass empty array to disable tracking.
     * Use takeComputedStyleUpdates to retrieve the list of nodes that had properties modified.
     * The changes to computed style properties are only tracked for nodes pushed to the front-end
     * by the DOM agent. If no changes to the tracked properties occur after the node has been pushed
     * to the front-end, no updates will be issued for the node.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param propertiesToTrack -
     * 
     * @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> trackComputedStyleUpdates
        (CSS.CSSComputedStyleProperty[] propertiesToTrack)
    {
        // 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 (propertiesToTrack == null) BRDPC.throwNPE("propertiesToTrack");
        
        final int       webSocketID = 12013000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("trackComputedStyleUpdates"),
            parameterNames.get("trackComputedStyleUpdates"),
            optionals, webSocketID,
            "CSS.trackComputedStyleUpdates",
            (Object) propertiesToTrack
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Polls the next batch of computed style updates.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * int[]&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * int[]&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>int[] (<B>nodeIds</B></CODE>)
     *     <BR />The list of node Ids that have their tracked computed styles updated
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, int[]> takeComputedStyleUpdates()
    {
        final int          webSocketID = 12014000 + counter++;
        final boolean[]    optionals   = new boolean[0];
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("takeComputedStyleUpdates"),
            parameterNames.get("takeComputedStyleUpdates"),
            optionals, webSocketID,
            "CSS.takeComputedStyleUpdates"
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'int[]'
        Function<JsonObject, int[]> responseProcessor = (JsonObject jo) ->
            (jo.getJsonArray("nodeIds") == null)
                ? null
                : ReadArrJSON.DimN.intArr(jo.getJsonArray("nodeIds"), -1, 0, null, int[].class);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Find a rule with the given active property for the given node and set the new value for this
     * property
     * 
     * @param nodeId The element id for which to set property.
     * 
     * @param propertyName -
     * 
     * @param value -
     * 
     * @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> setEffectivePropertyValueForNode
        (int nodeId, String propertyName, String value)
    {
        // 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 (propertyName == null) BRDPC.throwNPE("propertyName");
        if (value == null)        BRDPC.throwNPE("value");
        
        final int       webSocketID = 12015000 + counter++;
        final boolean[] optionals   = { false, false, false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setEffectivePropertyValueForNode"),
            parameterNames.get("setEffectivePropertyValueForNode"),
            optionals, webSocketID,
            "CSS.setEffectivePropertyValueForNode",
            nodeId, propertyName, value
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Modifies the keyframe rule key text.
     * 
     * @param styleSheetId -
     * 
     * @param range -
     * 
     * @param keyText -
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link CSS.Value}&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * {@link CSS.Value}&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>{@link CSS.Value} (<B>keyText</B></CODE>)
     *     <BR />The resulting key text after modification.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, CSS.Value> setKeyframeKey
        (String styleSheetId, CSS.SourceRange range, String keyText)
    {
        // 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 (styleSheetId == null) BRDPC.throwNPE("styleSheetId");
        if (range == null)        BRDPC.throwNPE("range");
        if (keyText == null)      BRDPC.throwNPE("keyText");
        
        final int       webSocketID = 12016000 + counter++;
        final boolean[] optionals   = { false, false, false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setKeyframeKey"),
            parameterNames.get("setKeyframeKey"),
            optionals, webSocketID,
            "CSS.setKeyframeKey",
            styleSheetId, range, keyText
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'CSS.Value'
        Function<JsonObject, CSS.Value> responseProcessor = (JsonObject jo) ->
            ReadJSON.getObject(jo, "keyText", CSS.Value.class, false, true);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Modifies the rule selector.
     * 
     * @param styleSheetId -
     * 
     * @param range -
     * 
     * @param text -
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link CSS.CSSMedia}&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * {@link CSS.CSSMedia}&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>{@link CSS.CSSMedia} (<B>media</B></CODE>)
     *     <BR />The resulting CSS media rule after modification.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, CSS.CSSMedia> setMediaText
        (String styleSheetId, CSS.SourceRange range, 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 (styleSheetId == null) BRDPC.throwNPE("styleSheetId");
        if (range == null)        BRDPC.throwNPE("range");
        if (text == null)         BRDPC.throwNPE("text");
        
        final int       webSocketID = 12017000 + counter++;
        final boolean[] optionals   = { false, false, false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setMediaText"),
            parameterNames.get("setMediaText"),
            optionals, webSocketID,
            "CSS.setMediaText",
            styleSheetId, range, text
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'CSS.CSSMedia'
        Function<JsonObject, CSS.CSSMedia> responseProcessor = (JsonObject jo) ->
            ReadJSON.getObject(jo, "media", CSS.CSSMedia.class, false, true);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Modifies the expression of a container query.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param styleSheetId -
     * 
     * @param range -
     * 
     * @param text -
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link CSS.CSSContainerQuery}&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * {@link CSS.CSSContainerQuery}&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>{@link CSS.CSSContainerQuery} (<B>containerQuery</B></CODE>)
     *     <BR />The resulting CSS container query rule after modification.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, CSS.CSSContainerQuery> setContainerQueryText
        (String styleSheetId, CSS.SourceRange range, 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 (styleSheetId == null) BRDPC.throwNPE("styleSheetId");
        if (range == null)        BRDPC.throwNPE("range");
        if (text == null)         BRDPC.throwNPE("text");
        
        final int       webSocketID = 12018000 + counter++;
        final boolean[] optionals   = { false, false, false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setContainerQueryText"),
            parameterNames.get("setContainerQueryText"),
            optionals, webSocketID,
            "CSS.setContainerQueryText",
            styleSheetId, range, text
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'CSS.CSSContainerQuery'
        Function<JsonObject, CSS.CSSContainerQuery> responseProcessor = (JsonObject jo) ->
            ReadJSON.getObject(jo, "containerQuery", CSS.CSSContainerQuery.class, false, true);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Modifies the rule selector.
     * 
     * @param styleSheetId -
     * 
     * @param range -
     * 
     * @param selector -
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link CSS.SelectorList}&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * {@link CSS.SelectorList}&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>{@link CSS.SelectorList} (<B>selectorList</B></CODE>)
     *     <BR />The resulting selector list after modification.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, CSS.SelectorList> setRuleSelector
        (String styleSheetId, CSS.SourceRange range, String selector)
    {
        // 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 (styleSheetId == null) BRDPC.throwNPE("styleSheetId");
        if (range == null)        BRDPC.throwNPE("range");
        if (selector == null)     BRDPC.throwNPE("selector");
        
        final int       webSocketID = 12019000 + counter++;
        final boolean[] optionals   = { false, false, false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setRuleSelector"),
            parameterNames.get("setRuleSelector"),
            optionals, webSocketID,
            "CSS.setRuleSelector",
            styleSheetId, range, selector
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'CSS.SelectorList'
        Function<JsonObject, CSS.SelectorList> responseProcessor = (JsonObject jo) ->
            ReadJSON.getObject(jo, "selectorList", CSS.SelectorList.class, false, true);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Sets the new stylesheet text.
     * 
     * @param styleSheetId -
     * 
     * @param text -
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * String&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * String&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>String (<B>sourceMapURL</B></CODE>)
     *     <BR />URL of source map associated with script (if any).
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, String> setStyleSheetText
        (String styleSheetId, 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 (styleSheetId == null) BRDPC.throwNPE("styleSheetId");
        if (text == null)         BRDPC.throwNPE("text");
        
        final int       webSocketID = 12020000 + counter++;
        final boolean[] optionals   = { false, false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setStyleSheetText"),
            parameterNames.get("setStyleSheetText"),
            optionals, webSocketID,
            "CSS.setStyleSheetText",
            styleSheetId, text
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'String'
        Function<JsonObject, String> responseProcessor = (JsonObject jo) ->
            ReadJSON.getString(jo, "sourceMapURL", true, false);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Applies specified style edits one after another in the given order.
     * 
     * @param edits -
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link CSS.CSSStyle}[]&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * {@link CSS.CSSStyle}[]&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>{@link CSS.CSSStyle}[] (<B>styles</B></CODE>)
     *     <BR />The resulting styles after modification.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, CSS.CSSStyle[]> setStyleTexts
        (CSS.StyleDeclarationEdit[] edits)
    {
        // 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 (edits == null) BRDPC.throwNPE("edits");
        
        final int       webSocketID = 12021000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setStyleTexts"),
            parameterNames.get("setStyleTexts"),
            optionals, webSocketID,
            "CSS.setStyleTexts",
            (Object) edits
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'CSS.CSSStyle[]'
        Function<JsonObject, CSS.CSSStyle[]> responseProcessor = (JsonObject jo) ->
            (jo.getJsonArray("styles") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("styles"), null, 0, CSS.CSSStyle[].class);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Enables the selector recording.
     * 
     * @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> startRuleUsageTracking()
    {
        final int          webSocketID = 12022000 + counter++;
        final boolean[]    optionals   = new boolean[0];
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("startRuleUsageTracking"),
            parameterNames.get("startRuleUsageTracking"),
            optionals, webSocketID,
            "CSS.startRuleUsageTracking"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Stop tracking rule usage and return the list of rules that were used since last call to
     * <CODE>takeCoverageDelta</CODE> (or since start of coverage instrumentation)
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link CSS.RuleUsage}[]&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * {@link CSS.RuleUsage}[]&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>{@link CSS.RuleUsage}[] (<B>ruleUsage</B></CODE>)
     *     <BR />-
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, CSS.RuleUsage[]> stopRuleUsageTracking()
    {
        final int          webSocketID = 12023000 + counter++;
        final boolean[]    optionals   = new boolean[0];
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("stopRuleUsageTracking"),
            parameterNames.get("stopRuleUsageTracking"),
            optionals, webSocketID,
            "CSS.stopRuleUsageTracking"
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'CSS.RuleUsage[]'
        Function<JsonObject, CSS.RuleUsage[]> responseProcessor = (JsonObject jo) ->
            (jo.getJsonArray("ruleUsage") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("ruleUsage"), null, 0, CSS.RuleUsage[].class);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Obtain list of rules that became used since last call to this method (or since start of coverage
     * instrumentation)
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret2}&gt;</CODE>
     *
     * <BR /><BR />This {@link Script} may be <B STYLE='color:red'>executed</B> (using 
     * {@link Script#exec()}), and a {@link Promise} returned.
     *
     * <BR /><BR />When the {@code Promise} is <B STYLE='color: red'>awaited</B>
     * (using {@link Promise#await()}), the {@code Ret2} will subsequently
     * be returned from that call.
     * 
     * <BR /><BR />The <B STYLE='color: red'>returned</B> values are encapsulated
     * in an instance of <B>{@link Ret2}</B>
     *
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE><B>Ret2.a:</B> {@link CSS.RuleUsage}[] (<B>coverage</B>)</CODE>
     *     <BR />-
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret2.b:</B> Number (<B>timestamp</B>)</CODE>
     *     <BR />Monotonically increasing time, in seconds.
     *     </LI>
     * </UL>
     */
    public static Script<String, JsonObject, Ret2<CSS.RuleUsage[], Number>> takeCoverageDelta()
    {
        final int          webSocketID = 12024000 + counter++;
        final boolean[]    optionals   = new boolean[0];
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("takeCoverageDelta"),
            parameterNames.get("takeCoverageDelta"),
            optionals, webSocketID,
            "CSS.takeCoverageDelta"
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON into Java-Type 'Ret2'
        Function<JsonObject, Ret2<CSS.RuleUsage[], Number>> 
            responseProcessor = (JsonObject jo) -> new Ret2<>(
                (jo.getJsonArray("coverage") == null)
                    ? null
                    : ReadArrJSON.DimN.objArr(jo.getJsonArray("coverage"), null, 0, CSS.RuleUsage[].class),
                ReadNumberJSON.get(jo, "timestamp", false, true)
            );
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Enables/disables rendering of local CSS fonts (enabled by default).
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param enabled Whether rendering of local fonts is 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> setLocalFontsEnabled(boolean enabled)
    {
        final int       webSocketID = 12025000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setLocalFontsEnabled"),
            parameterNames.get("setLocalFontsEnabled"),
            optionals, webSocketID,
            "CSS.setLocalFontsEnabled",
            enabled
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
}