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>Reporting of performance timeline events, as specified in
 * https://w3c.github.io/performance-timeline/#dom-performanceobserver.</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 PerformanceTimeline
{
    // ********************************************************************************************
    // ********************************************************************************************
    // Class Header Stuff
    // ********************************************************************************************
    // ********************************************************************************************


    // No Pubic Constructors
    private PerformanceTimeline () { }

    // 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 : PerformanceTimeline.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>(1);
        parameterNames.put("enable", v);
        Collections.addAll(v, new String[]
        { "eventTypes", });
    }


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

    /** See https://github.com/WICG/LargestContentfulPaint and largest_contentful_paint.idl */
    public static class LargestContentfulPaint
        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, true, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final Number renderTime;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final Number loadTime;
        
        /** The number of pixels being painted. */
        public final Number size;
        
        /**
         * The id attribute of the element, if available.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String elementId;
        
        /**
         * The URL of the image (may be trimmed).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String url;
        
        /**
         * <CODE>[No Description Provided by Google]</CODE>
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Integer nodeId;
        
        /**
         * Constructor
         *
         * @param renderTime -
         * 
         * @param loadTime -
         * 
         * @param size The number of pixels being painted.
         * 
         * @param elementId The id attribute of the element, if available.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param url The URL of the image (may be trimmed).
         * <BR /><B>OPTIONAL</B>
         * 
         * @param nodeId -
         * <BR /><B>OPTIONAL</B>
         */
        public LargestContentfulPaint(
                Number renderTime, Number loadTime, Number size, String elementId, String url, 
                Integer nodeId
            )
        {
            // 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 (renderTime == null) BRDPC.throwNPE("renderTime");
            if (loadTime == null)   BRDPC.throwNPE("loadTime");
            if (size == null)       BRDPC.throwNPE("size");
            
            this.renderTime  = renderTime;
            this.loadTime    = loadTime;
            this.size        = size;
            this.elementId   = elementId;
            this.url         = url;
            this.nodeId      = nodeId;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'LargestContentfulPaint'}.
         */
        public LargestContentfulPaint (JsonObject jo)
        {
            this.renderTime  = ReadNumberJSON.get(jo, "renderTime", false, true);
            this.loadTime    = ReadNumberJSON.get(jo, "loadTime", false, true);
            this.size        = ReadNumberJSON.get(jo, "size", false, true);
            this.elementId   = ReadJSON.getString(jo, "elementId", true, false);
            this.url         = ReadJSON.getString(jo, "url", true, false);
            this.nodeId      = ReadBoxedJSON.getInteger(jo, "nodeId", 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;
        
            LargestContentfulPaint o = (LargestContentfulPaint) other;
        
            return
                    Objects.equals(this.renderTime, o.renderTime)
                &&  Objects.equals(this.loadTime, o.loadTime)
                &&  Objects.equals(this.size, o.size)
                &&  Objects.equals(this.elementId, o.elementId)
                &&  Objects.equals(this.url, o.url)
                &&  Objects.equals(this.nodeId, o.nodeId);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.renderTime)
                +   Objects.hashCode(this.loadTime)
                +   Objects.hashCode(this.size)
                +   Objects.hashCode(this.elementId)
                +   Objects.hashCode(this.url)
                +   Objects.hashCode(this.nodeId);
        }
    }
    
    /** <CODE>[No Description Provided by Google]</CODE> */
    public static class LayoutShiftAttribution
        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, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final DOM.Rect previousRect;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final DOM.Rect currentRect;
        
        /**
         * <CODE>[No Description Provided by Google]</CODE>
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Integer nodeId;
        
        /**
         * Constructor
         *
         * @param previousRect -
         * 
         * @param currentRect -
         * 
         * @param nodeId -
         * <BR /><B>OPTIONAL</B>
         */
        public LayoutShiftAttribution
            (DOM.Rect previousRect, DOM.Rect currentRect, Integer nodeId)
        {
            // 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 (previousRect == null) BRDPC.throwNPE("previousRect");
            if (currentRect == null)  BRDPC.throwNPE("currentRect");
            
            this.previousRect  = previousRect;
            this.currentRect   = currentRect;
            this.nodeId        = nodeId;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'LayoutShiftAttribution'}.
         */
        public LayoutShiftAttribution (JsonObject jo)
        {
            this.previousRect  = ReadJSON.getObject(jo, "previousRect", DOM.Rect.class, false, true);
            this.currentRect   = ReadJSON.getObject(jo, "currentRect", DOM.Rect.class, false, true);
            this.nodeId        = ReadBoxedJSON.getInteger(jo, "nodeId", 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;
        
            LayoutShiftAttribution o = (LayoutShiftAttribution) other;
        
            return
                    Objects.equals(this.previousRect, o.previousRect)
                &&  Objects.equals(this.currentRect, o.currentRect)
                &&  Objects.equals(this.nodeId, o.nodeId);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.previousRect.hashCode()
                +   this.currentRect.hashCode()
                +   Objects.hashCode(this.nodeId);
        }
    }
    
    /** See https://wicg.github.io/layout-instability/#sec-layout-shift and layout_shift.idl */
    public static class LayoutShift
        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, }; }
        
        /** Score increment produced by this event. */
        public final Number value;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final boolean hadRecentInput;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final Number lastInputTime;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final PerformanceTimeline.LayoutShiftAttribution[] sources;
        
        /**
         * Constructor
         *
         * @param value Score increment produced by this event.
         * 
         * @param hadRecentInput -
         * 
         * @param lastInputTime -
         * 
         * @param sources -
         */
        public LayoutShift(
                Number value, boolean hadRecentInput, Number lastInputTime, 
                PerformanceTimeline.LayoutShiftAttribution[] sources
            )
        {
            // 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 (lastInputTime == null) BRDPC.throwNPE("lastInputTime");
            if (sources == null)       BRDPC.throwNPE("sources");
            
            this.value           = value;
            this.hadRecentInput  = hadRecentInput;
            this.lastInputTime   = lastInputTime;
            this.sources         = sources;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'LayoutShift'}.
         */
        public LayoutShift (JsonObject jo)
        {
            this.value           = ReadNumberJSON.get(jo, "value", false, true);
            this.hadRecentInput  = ReadPrimJSON.getBoolean(jo, "hadRecentInput");
            this.lastInputTime   = ReadNumberJSON.get(jo, "lastInputTime", false, true);
            this.sources = (jo.getJsonArray("sources") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("sources"), null, 0, PerformanceTimeline.LayoutShiftAttribution[].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;
        
            LayoutShift o = (LayoutShift) other;
        
            return
                    Objects.equals(this.value, o.value)
                &&  (this.hadRecentInput == o.hadRecentInput)
                &&  Objects.equals(this.lastInputTime, o.lastInputTime)
                &&  Arrays.deepEquals(this.sources, o.sources);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.value)
                +   (this.hadRecentInput ? 1 : 0)
                +   Objects.hashCode(this.lastInputTime)
                +   Arrays.deepHashCode(this.sources);
        }
    }
    
    /** <CODE>[No Description Provided by Google]</CODE> */
    public static class TimelineEvent
        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, true, true, true, }; }
        
        /** Identifies the frame that this event is related to. Empty for non-frame targets. */
        public final String frameId;
        
        /**
         * The event type, as specified in https://w3c.github.io/performance-timeline/#dom-performanceentry-entrytype
         * This determines which of the optional "details" fiedls is present.
         */
        public final String type;
        
        /** Name may be empty depending on the type. */
        public final String name;
        
        /** Time in seconds since Epoch, monotonically increasing within document lifetime. */
        public final Number time;
        
        /**
         * Event duration, if applicable.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Number duration;
        
        /**
         * <CODE>[No Description Provided by Google]</CODE>
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final PerformanceTimeline.LargestContentfulPaint lcpDetails;
        
        /**
         * <CODE>[No Description Provided by Google]</CODE>
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final PerformanceTimeline.LayoutShift layoutShiftDetails;
        
        /**
         * Constructor
         *
         * @param frameId Identifies the frame that this event is related to. Empty for non-frame targets.
         * 
         * @param type 
         * The event type, as specified in https://w3c.github.io/performance-timeline/#dom-performanceentry-entrytype
         * This determines which of the optional "details" fiedls is present.
         * 
         * @param name Name may be empty depending on the type.
         * 
         * @param time Time in seconds since Epoch, monotonically increasing within document lifetime.
         * 
         * @param duration Event duration, if applicable.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param lcpDetails -
         * <BR /><B>OPTIONAL</B>
         * 
         * @param layoutShiftDetails -
         * <BR /><B>OPTIONAL</B>
         */
        public TimelineEvent(
                String frameId, String type, String name, Number time, Number duration, 
                PerformanceTimeline.LargestContentfulPaint lcpDetails, 
                PerformanceTimeline.LayoutShift layoutShiftDetails
            )
        {
            // 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");
            if (type == null)    BRDPC.throwNPE("type");
            if (name == null)    BRDPC.throwNPE("name");
            if (time == null)    BRDPC.throwNPE("time");
            
            this.frameId             = frameId;
            this.type                = type;
            this.name                = name;
            this.time                = time;
            this.duration            = duration;
            this.lcpDetails          = lcpDetails;
            this.layoutShiftDetails  = layoutShiftDetails;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'TimelineEvent'}.
         */
        public TimelineEvent (JsonObject jo)
        {
            this.frameId             = ReadJSON.getString(jo, "frameId", false, true);
            this.type                = ReadJSON.getString(jo, "type", false, true);
            this.name                = ReadJSON.getString(jo, "name", false, true);
            this.time                = ReadNumberJSON.get(jo, "time", false, true);
            this.duration            = ReadNumberJSON.get(jo, "duration", true, false);
            this.lcpDetails          = ReadJSON.getObject(jo, "lcpDetails", PerformanceTimeline.LargestContentfulPaint.class, true, false);
            this.layoutShiftDetails  = ReadJSON.getObject(jo, "layoutShiftDetails", PerformanceTimeline.LayoutShift.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;
        
            TimelineEvent o = (TimelineEvent) other;
        
            return
                    Objects.equals(this.frameId, o.frameId)
                &&  Objects.equals(this.type, o.type)
                &&  Objects.equals(this.name, o.name)
                &&  Objects.equals(this.time, o.time)
                &&  Objects.equals(this.duration, o.duration)
                &&  Objects.equals(this.lcpDetails, o.lcpDetails)
                &&  Objects.equals(this.layoutShiftDetails, o.layoutShiftDetails);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.frameId)
                +   Objects.hashCode(this.type)
                +   Objects.hashCode(this.name)
                +   Objects.hashCode(this.time)
                +   Objects.hashCode(this.duration)
                +   this.lcpDetails.hashCode()
                +   this.layoutShiftDetails.hashCode();
        }
    }
    
    /** Sent when a performance timeline event is added. See reportPerformanceTimeline method. */
    public static class timelineEventAdded
        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 PerformanceTimeline.TimelineEvent event;
        
        /**
         * Constructor
         *
         * @param event -
         */
        public timelineEventAdded(PerformanceTimeline.TimelineEvent event)
        {
            super("PerformanceTimeline", "timelineEventAdded", 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 (event == null) BRDPC.throwNPE("event");
            
            this.event  = event;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'timelineEventAdded'}.
         */
        public timelineEventAdded (JsonObject jo)
        {
            super("PerformanceTimeline", "timelineEventAdded", 1);
        
            this.event  = ReadJSON.getObject(jo, "event", PerformanceTimeline.TimelineEvent.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;
        
            timelineEventAdded o = (timelineEventAdded) other;
        
            return
                    Objects.equals(this.event, o.event);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.event.hashCode();
        }
    }
    
    
    // Counter for keeping the WebSocket Request ID's distinct.
    private static int counter = 1;
    
    /**
     * Previously buffered events would be reported before method returns.
     * See also: timelineEventAdded
     * 
     * @param eventTypes 
     * The types of event to report, as specified in
     * https://w3c.github.io/performance-timeline/#dom-performanceentry-entrytype
     * The specified filter overrides any previous filters, passing empty
     * filter disables recording.
     * Note that not all types exposed to the web platform are currently supported.
     * 
     * @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(String[] eventTypes)
    {
        // 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 (eventTypes == null) BRDPC.throwNPE("eventTypes");
        
        final int       webSocketID = 34000000 + counter++;
        final boolean[] optionals   = { false, };
        
        // 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,
            "PerformanceTimeline.enable",
            (Object) eventTypes
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
}