/*************************************************************************************************/
/*************************************************************************************************/
/* This defines the Complete CSS-Definition List of all uses of Color by the Upgrader            */
/*************************************************************************************************/
/*************************************************************************************************/


/*
 * This file has unified all of the colors that are used throughout all Upgrader-Created Color
 * Definitions.  Each use of a color on any of the major CSS-Files has been extracted, removed and
 * replaced with a CSS-Variable "var(xxx)" definition.
 *
 * Each CSS-Variable for the use of a color has been placed inside this file.  The purpsoe of this
 * is to facilitate changing all colors in a centralized and planned fasion - making it much easier
 * to see / view what changes to one color-setting will look like with regard to other colors on
 * the page.
 */

:root
{
    /*********************************************************************************************/
    /*********************************************************************************************/
    /* Java Doc  **ORIGINAL**  Already-Defined Colors                                            */
    /*********************************************************************************************/
    /*********************************************************************************************/


    --JD-Gold:          #f8981d;
    --JD-Brown:         #bb7a2a;
    --JD-Blue:          #0066FF;

    --JD-Gray1:         #dee3e9;
    --JD-Gray2:         #d0d9e0;

    --JD-White1:        #ffffff;
    --JD-White2:        #f8f8f8;
    --JD-White3:        #eeeeff;

    --JD-DarkBlue1:     #4a6782;
    --JD-DarkBlue2:     #4d7a97;

    --JD-DarkGray1:     #353833;
    --JD-DarkGray2:     #253441;
    --JD-DarkGray3:     #2c4557;
    --JD-DarkGray4:     #4E4E4E;
    --JD-DarkGray5:     #474747;


    /*********************************************************************************************/
    /*********************************************************************************************/
    /* Colors Used in "Original-Widgets.css"                                                     */
    /*********************************************************************************************/
    /*********************************************************************************************/


    /* The Label-Text at the top of a Page that has the "Package-Name" */
    --Package-Label-Color:  black;
    --Package-Label-Border: #f0c300;
    --Package-Label-Shadow: rgba(0,0,0,0.35);
    --Package-Label-BG1:    #f0c300;
    --Package-Label-BG2:    #ffdf7f;

    /* The Label-Text at the top of a Page that has the Name of the Class, Interface, Enum...*/
    --CIET-Title-Color:         white;
    --CIET-Title-Background:    black;

    /*
     * Signature Boxes are included on every Detail-Element (Method, Field, Constructor etc...)
     * The top of every Java-Doc Page also has a Class/Interface/Enum... "Signature"
     * NOTE: The "Signature" is a white-box with black-text that has a "Hovering Effect"
     */
    --Signature-Shadow: rgba(0,0,0,0.65);

    /** Shadow for the "Specified By", "Type-Parameters", "Parameters", "Returns" & "Throws" */
    --Detail-Elements-Shadow: rgba(0,0,0,0.35);

    /** Shadow for the CINZEL "Method-Summary", "Method-Details", "Field-Summary", etc... */
    --Summary-Detail-Shadow: rgba(0,0,0,0.35);

    /* The Text-Description of the CIET/Type (Class, Interface, Enum...) at the top of Page. */
    --Top-Description-Background:   AliceBlue;
    --Top-Description-Border1:      #eee;
    --Top-Description-Border2:      #777;

    /* The Text-Description of each Detail-Element (Method, Field, Constructor, etc...) */
    --Detail-Description-Background: Beige;

    /* Detail-Element Name.  At the top of every Detail (Method, Field, Constructor...) */
    --Detail-Name-Color:        black;
    --Detail-Name-Border1:      #eee;
    --Detail-Name-Border2:      #777;
    --Detail-Name-Background:   lightskyblue;

    /*
     * Parameter Descriptions Colors - For any Parameters listed inside of a Detail-Section
     * These simply state a Parameter's Name.  They are smaller bars with slightly rounded-corners
     */
    --Parameter-Color:      black;
    --Parameter-Background: lightgreen;

    /*
     * Throws Description Colors - For any Exceptions/Errors that are listed in a Detail-Section
     * As above, they state an Exception's Name.  They have rounded-corners (border-radius).
     * Since they may be linked to an Exception's Page, they have <A HREF> / Anchor's in them.
     */
    --Throws-Color:         white;
    --Throws-Background:    #4d7a97; /* --JD-DarkBlue2 */
    --Throws-Anchor:        white;
    --Throws-Anchor-Hover:  #f8981d; /* --JD-Gold */

    /*
     * Type-Parameter Descriptions Colors - For any Type-Parameters Descriptions in a Detail
     * Also as above, but much less common as few methods / constructors have Type-Parameters
     */
    --Type-Parameter-Color:         black;
    --Type-Parameter-Background:    lightskyblue;

    /*
     * Cinzel Section Labels: The Big Giant Title-Bars that say things like: "Method Details",
     * "Field Summary" or "Constructor Details".
     * The font-family used is called "Cinzel" - I got it off of Google one day.
     */
    --Cinzel-Title-Color:           black;
    --Cinzel-Title-Radial-Color1:   #fff;
    --Cinzel-Title-Radial-Color2:   #eee;
    --Cinzel-Title-Radial-Color3:   #ddd;
    --Cinzel-Title-Shadow:          rgba(0,0,0,0.35);

    /*
     * Detail <DD> / <DT> Labels: The Labels inside JavaDoc "Detail Elements" that simply say:
     * "Returns", "Throws", "Parameters", "Overrides", "Specified By", "Author" etc...
     */
    --Detail-DDDT-Color:    black;
    --Detail-DDDT-Linear1:  Khaki;
    --Detail-DDDT-Linear2:  BurlyWood;
    --Detail-DDDT-Border1:  lightgray;
    --Detail-DDDT-Border2:  black;


    /*********************************************************************************************/
    /*********************************************************************************************/
    /* Colors Used in "Upgrader-Widgets.css"                                                     */
    /*********************************************************************************************/
    /*********************************************************************************************/


    /*
     * These are two links that are added by the Upgrader to the Top of a Java-Doc Page.
     * They include a link to the HiLited Source Code, and a "StatelessClass" Explanation
     */
    --Source-Link-Background:       lightyellow;
    --Source-Link-Title-Background: #dee3e9; /* --JD-Gray1 */
    --Stateless-Class-Background:   lightyellow;

    /*
     * The Corner-Stone of Sorting Summary-Tables.  These are those cute litttle Orange-Banners
     * That start in "JavaDoc Gold" and end in "JavaDoc White".  These are the banners that group
     * Overloaded Methods in a Summary-Table into a single Group with a Dithered-Title / Header
     */
    --Summary-Section-Dithered-Start:   #f8981d; /* --JD-Gold */
    --Summary-Section-Dithered-End:     #f8f8f8; /* --JD-White2 */

    /*
     * Simple Foreground Color for the Dithered-Banners that allows the Summary-Section Titles to
     * Contain a Brief "Leading Title Text".
     * 
     * Used in Java-Doc Pages as: <B CLASS=STBLabel>Leading Summary Category Text:</B> More Text
     * Often says things such as: <B CLASS-STBLabel>Methods: java.lang.Iterable</B> ...
     */
    --Summary-Table-Entry-Leading-Text: white;
    --Summary-Table-Anchor-Text:        blue;
    --Summary-Table-Anchor-Text-Hover:  lightskyblue; /* --JD-Gold */


    /* Convenience Methods & Constructors */
    --Convenience-Detail-Label-Color:       white;
    --Convenience-Detail-Label-Background:  #bb7a2a; /* --JD-Brown */
    --Convenience-Dithered-Start:           lightyellow;
    --Convenience-Dithered-End:             #bb7a2a; /* --JD-Brown */

    /* Tables Used inside Convenience Methods & Constructors */
    --Convenience-Link-Color:               blue;
    --Convenience-Link-Color-Hover:         lightskyblue;

    /*
     * Statistics Page.  Java-Doc Upgrader puts a "Stats" Button in the top right hand corner of 
     * all pages.  This page that pops up uses this color scheme.
     */
    --Stats-HeaderRow-Color:        white;
    --Stats-HeaderRow-Background:   black;
    --Stats-Body:                   #dee3e9; /* --JD-Gray1 */
    --Stats-Package-Name:           lightgreen;
    --Stats-Totals-Complete:        lightyellow;

    /*
     * Rarely Used.  If the user has disabled Java-Script in their browser, there is a small Popup
     * Message that informs them of this fact, if they attempt to use features that require
     * Java-Script.  Note that this Popup-Notice isn't actually enable for everything on the page
     * that requires Java-Script.  The Detail Button-Bars do not render this at message at all.
     */
    --NO-SCRIPT-Popup-Color:        darkred;
    --NO-SCRIPT-Popup-Background:   white;
    --NO-SCRIPT-Popup-Border:       black;

    /*
     * Details-List Popup Menu.  This is a Popup-Menu attached to a Button in the Top-Right-Corner
     * of a Java-Doc Page.  It's Label is just simply titled "Menu".  Its contents list everything
     * that is contained on the Summary-Tabel.  Specifically, it has Menu-Item Links to all
     * Methods, Field, Constructors etc... on the Page.
     */
    --Details-Popup-Item:                   black;
    --Details-Popup-Item-Hover-Color:       darkred;
    --Details-Popup-Item-Hover-Background:  lightgray;
    --Details-Popup-Hide:                   white;
    --Details-Popup-Label-Background:       #4d7a97; /* --JD-DarkBlue2  */
    --Details-Popup-Label-Border:           #0066FF; /* --JD-Blue       */

    /*
     * The Top-Right-Corner of a Java-Doc Page has a set of three buttons.  These buttons allow
     * a user to Minimize, Parialize or Maximize all Details on the entire page with a single
     * button press.
     */
    --Min-Max-Part-All-Color:               black;
    --Min-Max-Part-All-Background-Left:     #f8981d; /* --JD-Gold */
    --Min-Max-Part-All-Background-Right:    #f8f8f8; /* --JD-White2 */

    /*
     * The Buttons directly below the Signature Part of each Detail-Entry on a page.
     * There are four buttons for going up, down, top and to the HiLited Source Code on the Left.
     * On the right are three buttons to minimize, partialize or maximize a Detail-Entry
     */
    --Detail-Nav-Bar-Button-Color:              black;
    --Detail-Nav-Bar-Button-Background:         Cornsilk;
    --Detail-Nav-Bar-Button-Border:             FireBrick;

    --Detail-Nav-Bar-Button-Hover-Color:        white;
    --Detail-Nav-Bar-Button-Hover-Background:   FireBrick;

    --Detail-Nav-Bar-Button-Shadow1:            rgba(0, 0, 0, 0.3);
    --Detail-Nav-Bar-Button-Shadow2:            rgba(255, 255, 255, 0.2);
    --Detail-Nav-Bar-Button-Shadow3:            rgba(0, 0, 0, 0.4);

    --Detail-Nav-Bar-Button-Press-Shadow1:      rgba(0, 0, 0, 0.5);
    --Detail-Nav-Bar-Button-Press-Shadow2:      rgba(255, 255, 255, 0.1);

    /* 
     * Each Details-Element has a Navigation-Bar Row of (currently) 7 Buttons.  One of them is a
     * double up-arrow which relocates the page to the top Summary-Table Row-Entry that corresponds
     * to the Detail-Element that had the double up-arrow that was clicked.
     *
     * When this button is clicked and the page relocated, the Summary-Table Row Blinks and Flashes
     * for exactly 1.5 seconds (750 ms x 2) .  The color of the flashing is as here, below:
     */
    --Summary-Row-Flash-Color:      white;
    --Summary-Row-Flash-Background: #0066FF; /* --JD-Blue */

    /*
     * The "Jump and Flash" Feature is identical to the Flash Summary Table Rows Feature which is
     * initiated when a User clicks a Detail-Member's "Double-Up-Array Button" - bringing him to
     * the Summary-Table where his Detail-Entity (Class Member) has first been defined or
     * summarized.
     * 
     * In December of 2024, this feature was futher extended to allow user's to provide links to 
     * any element on an HTML-Page, so long as an HTML #ID is provided, and the Java-Script 
     * "onclick='...'" Listener is applied.
     * 
     * These are the *DEFAULT* colors used to Flash the HTML-Tag's Contents.  They may be changed
     * by hard-coding the expected colors into the Java-Script call itself.
     * 
     * IMPORTANT NOTE: The reason for "extending" this feature which was originall only used for
     *                 Summary-Table & Detail Entities is because Java-Doc page are EXTREMELY
     *                 DENSE, filled with information.  When a User clicks on an HTML-Anchor
     *                 <A HREF=...>, the browser relocates the page quickly, and in order to have 
     *                 a prayer of seeing exactly which piece of data was the, actual, intended
     *                 target of his or her "click", flashing the Data, Row, Column, etc...
     *                 can help a lot!
     */
    --Jump-And-Flash-Default-Color:         white;
    --Jump-And-Flash-Default-Background:    #4d7a97; /* --JD-DarkBlue2  */

    --
    /*
     * Each Detail-Element on a Java-Doc Web-Page has had its definition passed to a Source Hiliter
     * and put at the bottom of the Element.  For Method-Details, the Method-Body has been Hilited,
     * and placed directly below an HTML Label that simply states "Exact Method Body".  For
     * Constructors, the Label says "Exact Constructor Body", and for Fields it says "Exact Field
     * Declaration Expression"
     * 
     * The HiLiting itself is currently done by "Pygments.org", and there is an entire
     * "Pygments.org" CSS-File too.  This is just the color for the Label & Background.
     */
    --HiLite-Details-Label-Color:   #4d7a97; /* --JD-DarkBlue2 */
    --HiLite-Details-Background:    black;
    --HiLite-Details-Border:        gray;

    /*
     * The user has the option of creating HiLited Source Blocks to be inserted into the
     * Documentation too.  These HiLited HTML <DIV> Elements may contain Java, Java-Script, HTML,
     * CSS among others.
     * 
     * The <DIV> with the HiLited Source has an HTML Label above it explaining what the contents
     * are.  Some say "Example" other <DIV>'s may say "Line of Code".
     *
     * The actual <DIV> itself also has some colors defined here, below - along with 2 additional
     * special cases (Regular-Expressions, and Shell-Terminal Output).
     * 
     * The HiLiting itself is currently done by "Pygments.org", and there is an entire
     * "Pygments.org" CSS-File too.
     */
    --HiLited-DIV-Label-Color:          white;
    --HiLited-DIV-Label-BG1:            darkblue;
    --HiLited-DIV-Label-BG2:            var(--JD-Blue);
    --HiLited-DIV-Label-Shadow:         rgba(0,0,0,0.35);
    --HiLited-DIV-Label-Border:         #555;
    --HiLited-DIV-Label-Border-Bottom:  black;

    --HiLited-DIV-Background:   black;
    --HiLited-DIV-Border:       gray;
    --HiLited-DIV-Special-Case: lightgreen;
    --HiLited-DIV-RegEx:        white;

    /*
     * When a Complete Source-Code File is Hilited and converted into an HTML-File, these CSS Rules
     * are applied to the HTML in that file.  These are not the only rules applied to such files, 
     * just some of the extras.
     * 
     * The HiLiting itself is currently done by "Pygments.org", and there is an entire
     * "Pygments.org" CSS-File too.  This is just the color for the Border, Background &
     * Line-Number
     */
    --HiLited-SourceFile-Background:    #202020;
    --HiLited-SourceFile-Border:        gray;
    --HiLited-SourceFile-LineNum:       lightskyblue;

    /*
     * The Upgrader Annotation @JDHeaderBackgroundImg allows a user to insert External-HTML onto a
     * Wood-Plank that is placed / situated at the very top of a JavaDoc Web-page.
     * 
     * These are just some of the colors that are associated with the inserted HTML for that 
     * Upgrader-Annotaiton.  Obviously (hopefully it is obvious) that the user may place other
     * color definitions in the actual HTML that is inserted too.
     */
    --Wood-Plank-Header-Border: #660000;
    --Wood-Plank-Header-Shadow: rgba(0,0,0,0.65);

    --Wood-Plank-Header-Inner-DIV-Background: #fffef0;
    --Wood-Plank-Header-Inner-DIV-Border:     #bb7a2a; /* --JD-Brown */


    /*********************************************************************************************/
    /*********************************************************************************************/
    /* Colors Used in "User-Accesories.css"                                                      */
    /*********************************************************************************************/
    /*********************************************************************************************/


    /* <UL CLASS=JDUL>, <OL CLASS=JDOL> */
    --JDUL-Border:                      #f8981d; /* --JD-Gold */
    --JDOL-Border:                      #f8981d; /* --JD-Gold */

    /* <TABLE CLASS=JDBriefTable> */
    --JDBriefTable-Shadow:              rgba(0,0,0,0.65);
    --JDBriefTable-TH-Background:       #f8981d; /* --JD-Gold */
    --JDBriefTable-TR-Odd:              lightgray;
    --JDBriefTable-TR-Even:             white;
    --JDBriefTable-TR-Color:            black;

    /* <B CLASS=JDDescLabel> */
    --JDDescLabel-Color:                white;
    --JDDescLabel-Background:           black;

    /* <B CLASS=JDDescLabel2> */
    --JDDescLabel2-Color:               white;
    --JDDescLabel2-Background:          darkred;
    --JDDescLabel2-Shadow:              rgba(0,0,0,0.65);;
    --JDDescLabel2-Border:              black;

    /* I don't actually know why this isn't just 'lightskyblue' - very common on this page */
    --JDDescLabel-Anchor:               #B2FFFF;
    --JDDescLabel-Anchor-Hover:         var(--JD-Gold);

    /* <H2 CLASS=JDBanner> */
    --JDBanner-Color:   black;
    --JDBanner-Shadow:  rgba(0,0,0,0.35);
    --JDBanner-BG1:     var(--JD-Gray2);
    --JDBanner-BG2:     var(--JD-White2);
    --JDBanner-BG3:     lightskyblue;

    --JDBanner-Anchor:          darkgreen;
    --JDBanner-Anchor-Hover:    var(--JD-Gold);

    /* <IMG CLASS=JDIMG SRC=...> */
    --JDIMG-Border1: #003366;
    --JDIMG-Border2: #336699;
    --JDIMG-Border3: #555555;
    --JDIMG-Border4: #999999;

    /* <SPAN CLASS=JDFileDirName> */
    --JDFileDirName-Color:              lightgreen;
    --JDFileDirName-Border:             white;
    --JDFileDirName-Gradient-End:       black;
    --JDFileDirName-Gradient-Middle:    gray;

    /* <ANYTHING CLASS=MISC_HILITE> */
    --MISC-HILITE:                      #d0d9e0; /* --JD-Gray2 */

    /* <SPAN CLASS=CopiedJDK> */
    --CopiedJDK-Gradient-Start:         #fff;
    --CopiedJDK-Gradient-Middle:        #eee;
    --CopiedJDK-Gradient-Border:        darkred;

    /* <A CLASS=JDDetailLink>, <A CLASS=JDDownloadLink>, <A CLASS=JDReferenceFileLink> */
    --JD-Link-Color:                    #f2f3f4; /* "Anti-Flash White" */
    --JD-Link-Hover-Color:              #f8981d; /* --JD-Gold */
    --JD-Link-Background:               black;
    --JD-Link-Border:                   white;

    /* "HTML Tags HiLite" For Example: <B CLASS=JDHTags>&lt;DIV&gt;</B> */
    --JDHTags-Color:                    red;

    /* Essentially, this is only in Torello.JavaDoc.CSSTags - See that file for explanation */
    --JDExample-Shadow:                 rgba(0,0,0,0.65);
    --JDExInner-Background:             #fffef0;
    --JDExInner-Border:                 #bb7a2a; /* --JD-Brown */

    /* <TABLE CLASS=METHODS> and <TABLE CLASS=PARAMETERS> */
    --JD-Method-Param-Table-Shadow:     black;
    --JD-Method-Param-Table-TH:         lightblue;
    --JD-Method-Param-Table-TR:         black;
    --JD-Method-Param-Table-TR-Odd:     lightgray;
    --JD-Method-Param-Table-TR-Even:    white;
    --JD-Method-Param-Table-TD-Col1:    #bb7a2a; /* --JD-Brown */


    /*********************************************************************************************/
    /*********************************************************************************************/
    /* Colors Used in "List-Frames.css"                                                          */
    /*********************************************************************************************/
    /*********************************************************************************************/


    --Frames-Body-Color:        #353833;
    --Frames-Body-Background:   #ffffff;

    --Frames-H1-Color:          white;
    --Frames-H1-Background:     var(--JD-DarkBlue2);
    --Frames-H1-Border:         black;

    --Frames-H2-Color:          black;
    --Frames-H2-Background:     Beige; /*#dee3e9; /* --JD-Gray1 */

    --Frames-H1H2-Shadow1-Down:   rgba(0, 0, 0, 0.3);
    --Frames-H1H2-Shadow1-Up:     rgba(0, 0, 0, 0.4);
    --Frames-H1H2-Shadow2:        rgba(0, 0, 0, 0.2);
    --Frames-H1H2-Shadow3:        rgba(255, 255, 255, 0.5);

    --Frames-H1-Anchor:         white;
    --Frames-H1-Anchor-Hover:   #f8981d; /* --JD-Gold */

    --Frames-LI-Anchor:         #4a6782; /* --JD-DarkBlue1 */
    --Frames-LI-Anchor-Hover:   #bb7a2a; /* --JD-Brown */
}