package Torello.Browser.BrowserAPI;

// *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
// Java-HTML Imports
// *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***

import Torello.Browser.*;
import Torello.Browser.helper.*;
import Torello.Browser.JavaScriptAPI.*;
import Torello.JSON.*;

import Torello.Java.ReadOnly.ReadOnlyList;
import Torello.Java.ReadOnly.ReadOnlyArrayList;

import Torello.JavaDoc.Annotations.StaticFunctional;
import Torello.JavaDoc.Annotations.JDHeaderBackgroundImg;

import Torello.Browser.BrowserAPI.NestedHelpers.Commands.SystemInfo$$Commands;


// *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
// JDK Imports
// *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***

import javax.json.JsonObject;
import javax.json.JsonValue;

/**
 * <SPAN CLASS=COPIEDJDK><B>The SystemInfo domain defines methods and events for querying low-level system information.</B></SPAN>
 * <EMBED CLASS='external-html' DATA-FILE-ID=CDP.CODE_GEN_NOTE>
 */
@StaticFunctional@JDHeaderBackgroundImg(EmbedTagFileID="CDP.WOOD_PLANK_NOTE")
public class SystemInfo
{
    // No Pubic Constructors
    private SystemInfo() { }


    // ********************************************************************************************
    // ********************************************************************************************
    // Enumerated String Constants Lists
    // ********************************************************************************************
    // ********************************************************************************************


    /**
     * Image format of a given image.
     * <BR /><BR /><B CLASS=StrEnumType>String-Enumeration Type</B>
     */
    public static final ReadOnlyList<String> ImageType = new ReadOnlyArrayList<>
        (String.class, "jpeg", "unknown", "webp");

    /**
     * YUV subsampling type of the pixels of a given image.
     * <BR /><BR /><B CLASS=StrEnumType>String-Enumeration Type</B>
     */
    public static final ReadOnlyList<String> SubsamplingFormat = new ReadOnlyArrayList<>
        (String.class, "yuv420", "yuv422", "yuv444");



    // ********************************************************************************************
    // ********************************************************************************************
    // Basic Types
    // ********************************************************************************************
    // ********************************************************************************************


    /**
     * Describes a single graphics processor (GPU).
     * 
     * <EMBED CLASS=globalDefs DATA-DOMAIN=SystemInfo DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
    public static class GPUDevice
        extends BaseType<GPUDevice>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<SystemInfo.GPUDevice> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.Types.
                SystemInfo$$GPUDevice$$.singleton;

        /** PCI ID of the GPU vendor, if available; 0 otherwise. */
        public final Number vendorId;

        /** PCI ID of the GPU device, if available; 0 otherwise. */
        public final Number deviceId;

        /**
         * Sub sys ID of the GPU, only available on Windows.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final Number subSysId;

        /**
         * Revision of the GPU, only available on Windows.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final Number revision;

        /** String description of the GPU vendor, if the PCI ID is not available. */
        public final String vendorString;

        /** String description of the GPU device, if the PCI ID is not available. */
        public final String deviceString;

        /** String description of the GPU driver vendor. */
        public final String driverVendor;

        /** String description of the GPU driver version. */
        public final String driverVersion;

        /** Constructor.  Please review this class' fields for documentation. */
        public GPUDevice(
                ReadOnlyList<Boolean> isPresent, Number vendorId, Number deviceId, Number subSysId,
                Number revision, String vendorString, String deviceString, String driverVendor,
                String driverVersion
            )
        {
            super(singleton, Domains.SystemInfo, "GPUDevice", 8);

            this.vendorId       = vendorId;
            this.deviceId       = deviceId;
            this.subSysId       = subSysId;
            this.revision       = revision;
            this.vendorString   = vendorString;
            this.deviceString   = deviceString;
            this.driverVendor   = driverVendor;
            this.driverVersion  = driverVersion;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 8, "SystemInfo.GPUDevice");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static GPUDevice fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<GPUDevice> descriptor()
        { return singleton.descriptor(); }
    }

    /**
     * Provides information about the GPU(s) on the system.
     * 
     * <EMBED CLASS=globalDefs DATA-DOMAIN=SystemInfo DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
    public static class GPUInfo
        extends BaseType<GPUInfo>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<SystemInfo.GPUInfo> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.Types.
                SystemInfo$$GPUInfo$$.singleton;

        /** The graphics devices on the system. Element 0 is the primary GPU. */
        public final SystemInfo.GPUDevice[] devices;

        /**
         * An optional dictionary of additional GPU related attributes.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final JsonValue auxAttributes;

        /**
         * An optional dictionary of graphics features and their status.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final JsonValue featureStatus;

        /** An optional array of GPU driver bug workarounds. */
        public final String[] driverBugWorkarounds;

        /** Supported accelerated video decoding capabilities. */
        public final SystemInfo.VideoDecodeAcceleratorCapability[] videoDecoding;

        /** Supported accelerated video encoding capabilities. */
        public final SystemInfo.VideoEncodeAcceleratorCapability[] videoEncoding;

        /** Supported accelerated image decoding capabilities. */
        public final SystemInfo.ImageDecodeAcceleratorCapability[] imageDecoding;

        /** Constructor.  Please review this class' fields for documentation. */
        public GPUInfo(
                ReadOnlyList<Boolean> isPresent, GPUDevice[] devices, JsonValue auxAttributes,
                JsonValue featureStatus, String[] driverBugWorkarounds,
                VideoDecodeAcceleratorCapability[] videoDecoding,
                VideoEncodeAcceleratorCapability[] videoEncoding,
                ImageDecodeAcceleratorCapability[] imageDecoding
            )
        {
            super(singleton, Domains.SystemInfo, "GPUInfo", 7);

            this.devices                = devices;
            this.auxAttributes          = auxAttributes;
            this.featureStatus          = featureStatus;
            this.driverBugWorkarounds   = driverBugWorkarounds;
            this.videoDecoding          = videoDecoding;
            this.videoEncoding          = videoEncoding;
            this.imageDecoding          = imageDecoding;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 7, "SystemInfo.GPUInfo");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static GPUInfo fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<GPUInfo> descriptor()
        { return singleton.descriptor(); }
    }

    /**
     * Describes a supported image decoding profile with its associated minimum and
     * maximum resolutions and subsampling.
     * 
     * <EMBED CLASS=globalDefs DATA-DOMAIN=SystemInfo DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
    public static class ImageDecodeAcceleratorCapability
        extends BaseType<ImageDecodeAcceleratorCapability>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<SystemInfo.ImageDecodeAcceleratorCapability> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.Types.
                SystemInfo$$ImageDecodeAcceleratorCapability$$.singleton;

        /**
         * Image coded, e.g. Jpeg.
         * <EMBED CLASS='external-html' DATA-D=SystemInfo DATA-C=ImageType DATA-F=imageType DATA-FILE-ID=CDP.EL2>
         * @see BaseType#enumStrList(String)
         */
        public final String imageType;

        /** Maximum supported dimensions of the image in pixels. */
        public final SystemInfo.Size maxDimensions;

        /** Minimum supported dimensions of the image in pixels. */
        public final SystemInfo.Size minDimensions;

        /**
         * Optional array of supported subsampling formats, e.g. 4:2:0, if known.
         * <EMBED CLASS='external-html' DATA-D=SystemInfo DATA-C=SubsamplingFormat DATA-F=subsamplings DATA-FILE-ID=CDP.EL2>
         * @see BaseType#enumStrList(String)
         */
        public final String[] subsamplings;

        /** Constructor.  Please review this class' fields for documentation. */
        public ImageDecodeAcceleratorCapability(
                ReadOnlyList<Boolean> isPresent, String imageType, Size maxDimensions,
                Size minDimensions, String[] subsamplings
            )
        {
            super(singleton, Domains.SystemInfo, "ImageDecodeAcceleratorCapability", 4);

            this.imageType      = imageType;
            this.maxDimensions  = maxDimensions;
            this.minDimensions  = minDimensions;
            this.subsamplings   = subsamplings;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 4, "SystemInfo.ImageDecodeAcceleratorCapability");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static ImageDecodeAcceleratorCapability fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<ImageDecodeAcceleratorCapability> descriptor()
        { return singleton.descriptor(); }
    }

    /**
     * Represents process info.
     * 
     * <EMBED CLASS=globalDefs DATA-DOMAIN=SystemInfo DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
    public static class ProcessInfo
        extends BaseType<ProcessInfo>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<SystemInfo.ProcessInfo> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.Types.
                SystemInfo$$ProcessInfo$$.singleton;

        /** Specifies process type. */
        public final String type;

        /** Specifies process id. */
        public final int id;

        /**
         * Specifies cumulative CPU usage in seconds across all threads of the
         * process since the process start.
         */
        public final Number cpuTime;

        /** Constructor.  Please review this class' fields for documentation. */
        public ProcessInfo(ReadOnlyList<Boolean> isPresent, String type, int id, Number cpuTime)
        {
            super(singleton, Domains.SystemInfo, "ProcessInfo", 3);

            this.type       = type;
            this.id         = id;
            this.cpuTime    = cpuTime;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 3, "SystemInfo.ProcessInfo");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static ProcessInfo fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<ProcessInfo> descriptor()
        { return singleton.descriptor(); }
    }

    /**
     * Describes the width and height dimensions of an entity.
     * 
     * <EMBED CLASS=globalDefs DATA-DOMAIN=SystemInfo DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
    public static class Size
        extends BaseType<Size>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<SystemInfo.Size> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.Types.
                SystemInfo$$Size$$.singleton;

        /** Width in pixels. */
        public final int width;

        /** Height in pixels. */
        public final int height;

        /** Constructor.  Please review this class' fields for documentation. */
        public Size(ReadOnlyList<Boolean> isPresent, int width, int height)
        {
            super(singleton, Domains.SystemInfo, "Size", 2);

            this.width  = width;
            this.height = height;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 2, "SystemInfo.Size");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static Size fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<Size> descriptor()
        { return singleton.descriptor(); }
    }

    /**
     * Describes a supported video decoding profile with its associated minimum and
     * maximum resolutions.
     * 
     * <EMBED CLASS=globalDefs DATA-DOMAIN=SystemInfo DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
    public static class VideoDecodeAcceleratorCapability
        extends BaseType<VideoDecodeAcceleratorCapability>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<SystemInfo.VideoDecodeAcceleratorCapability> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.Types.
                SystemInfo$$VideoDecodeAcceleratorCapability$$.singleton;

        /** Video codec profile that is supported, e.g. VP9 Profile 2. */
        public final String profile;

        /** Maximum video dimensions in pixels supported for this |profile|. */
        public final SystemInfo.Size maxResolution;

        /** Minimum video dimensions in pixels supported for this |profile|. */
        public final SystemInfo.Size minResolution;

        /** Constructor.  Please review this class' fields for documentation. */
        public VideoDecodeAcceleratorCapability(
                ReadOnlyList<Boolean> isPresent, String profile, Size maxResolution,
                Size minResolution
            )
        {
            super(singleton, Domains.SystemInfo, "VideoDecodeAcceleratorCapability", 3);

            this.profile        = profile;
            this.maxResolution  = maxResolution;
            this.minResolution  = minResolution;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 3, "SystemInfo.VideoDecodeAcceleratorCapability");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static VideoDecodeAcceleratorCapability fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<VideoDecodeAcceleratorCapability> descriptor()
        { return singleton.descriptor(); }
    }

    /**
     * Describes a supported video encoding profile with its associated maximum
     * resolution and maximum framerate.
     * 
     * <EMBED CLASS=globalDefs DATA-DOMAIN=SystemInfo DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
    public static class VideoEncodeAcceleratorCapability
        extends BaseType<VideoEncodeAcceleratorCapability>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<SystemInfo.VideoEncodeAcceleratorCapability> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.Types.
                SystemInfo$$VideoEncodeAcceleratorCapability$$.singleton;

        /** Video codec profile that is supported, e.g H264 Main. */
        public final String profile;

        /** Maximum video dimensions in pixels supported for this |profile|. */
        public final SystemInfo.Size maxResolution;

        /**
         * Maximum encoding framerate in frames per second supported for this
         * |profile|, as fraction's numerator and denominator, e.g. 24/1 fps,
         * 24000/1001 fps, etc.
         */
        public final int maxFramerateNumerator;

        /** <CODE>[No Description Provided by Google]</CODE> */
        public final int maxFramerateDenominator;

        /** Constructor.  Please review this class' fields for documentation. */
        public VideoEncodeAcceleratorCapability(
                ReadOnlyList<Boolean> isPresent, String profile, Size maxResolution,
                int maxFramerateNumerator, int maxFramerateDenominator
            )
        {
            super(singleton, Domains.SystemInfo, "VideoEncodeAcceleratorCapability", 4);

            this.profile                    = profile;
            this.maxResolution              = maxResolution;
            this.maxFramerateNumerator      = maxFramerateNumerator;
            this.maxFramerateDenominator    = maxFramerateDenominator;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 4, "SystemInfo.VideoEncodeAcceleratorCapability");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static VideoEncodeAcceleratorCapability fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<VideoEncodeAcceleratorCapability> descriptor()
        { return singleton.descriptor(); }
    }


    // ********************************************************************************************
    // ********************************************************************************************
    // Command-Return Types
    // ********************************************************************************************
    // ********************************************************************************************


    /**
     * Returns information about the system.
     * 
     * <EMBED CLASS=globalDefs DATA-DOMAIN=SystemInfo DATA-API=BrowserAPI DATA-CMD=getInfo>
     * @see SystemInfo#getInfo
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_CMD_JDHBI")
    public static class getInfo$$RET
        extends BaseType<getInfo$$RET>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<SystemInfo.getInfo$$RET> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.CmdReturns.
                SystemInfo$$getInfo$$RET.singleton;

        /** Information about the GPUs on the system. */
        public final SystemInfo.GPUInfo gpu;

        /**
         * A platform-dependent description of the model of the machine. On Mac OS, this is, for
         * example, 'MacBookPro'. Will be the empty string if not supported.
         */
        public final String modelName;

        /**
         * A platform-dependent description of the version of the machine. On Mac OS, this is, for
         * example, '10.1'. Will be the empty string if not supported.
         */
        public final String modelVersion;

        /**
         * The command line string used to launch the browser. Will be the empty string if not
         * supported.
         */
        public final String commandLine;

        /** Constructor.  Please review this class' fields for documentation. */
        public getInfo$$RET(
                ReadOnlyList<Boolean> isPresent, GPUInfo gpu, String modelName,
                String modelVersion, String commandLine
            )
        {
            super(singleton, Domains.SystemInfo, "getInfo", 4);

            this.gpu            = gpu;
            this.modelName      = modelName;
            this.modelVersion   = modelVersion;
            this.commandLine    = commandLine;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 4, "SystemInfo.getInfo$$RET");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static getInfo$$RET fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<getInfo$$RET> descriptor()
        { return singleton.descriptor(); }
    }




    // ********************************************************************************************
    // ********************************************************************************************
    // Commands
    // ********************************************************************************************
    // ********************************************************************************************


    /**
     * Returns information about the feature state.
     * 
     * @param featureState -
     * 
     * @return An instance of <CODE>{@link Script}&lt;Boolean&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec(WebSocketSender) Script.exec}, and afterwards, a {@link Promise}
     * <CODE>&lt;Boolean&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
     * be retrieved.</I>
     *
     * <BR /><BR /><DIV CLASS=JDHint>
     * This Browser Function's {@code Promise} returns:
     * <CODE>Boolean (<B>featureEnabled</B>)</CODE>
     * </DIV>
     */
    public static Script<Boolean> getFeatureState(String featureState)
    {
        // Build the JSON Request-Object (as a String); only 1 Parameter is passed
        final String requestJSON = WriteJSON.get
            (CDPTypes.STRING, "featureState", false, "SystemInfo.getFeatureState", featureState);

        return new Script<>(
            Domains.SystemInfo, "getFeatureState", requestJSON,
            jo -> ReadBoxedJSON.getBoolean(jo, "featureEnabled", JFlag.RD_N | JFlag.RD_M, DV.NULL_BOOL),
            Boolean.class
        );
    }

    /**
     * Returns information about the system.
     * 
     * @return An instance of <CODE>{@link Script}&lt;{@link getInfo$$RET}&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec(WebSocketSender) Script.exec}, and afterwards, a {@link Promise}
     * <CODE>&lt;{@link getInfo$$RET}&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
     * be retrieved.</I>
     *
     * <BR /><BR /><DIV CLASS=JDHint>
     * This Browser Function's {@code Promise} returns:{@link getInfo$$RET}
     * A dedicated return type implies that the browser may return more than 1 datum
     * </DIV>
     */
    public static Script<getInfo$$RET> getInfo()
    {
        // Ultra-Simple Request JSON - Because this method has no parameters
        final String requestJSON = "{\"method\":\"SystemInfo.getInfo\"}";

        return new Script<>(
            Domains.SystemInfo, "getInfo", requestJSON,
            getInfo$$RET::fromJSON,
            getInfo$$RET.class
        );
    }

    /**
     * Returns information about all running processes.
     * 
     * @return An instance of <CODE>{@link Script}&lt;{@link SystemInfo.ProcessInfo}[]&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec(WebSocketSender) Script.exec}, and afterwards, a {@link Promise}
     * <CODE>&lt;{@link SystemInfo.ProcessInfo}[]&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
     * be retrieved.</I>
     *
     * <BR /><BR /><DIV CLASS=JDHint>
     * This Browser Function's {@code Promise} returns:
     * <CODE>{@link SystemInfo.ProcessInfo}[] (<B>processInfo</B>)</CODE>
     * <BR />
     * An array of process info blocks.
     * </DIV>
     */
    public static Script<SystemInfo.ProcessInfo[]> getProcessInfo()
    {
        // Ultra-Simple Request JSON - Because this method has no parameters
        final String requestJSON = "{\"method\":\"SystemInfo.getProcessInfo\"}";

        return new Script<>(
            Domains.SystemInfo, "getProcessInfo", requestJSON,
            SystemInfo$$Commands::getProcessInfo,
            SystemInfo.ProcessInfo[].class
        );
    }


}