/*
 * Copyright (c) 2010, 2020, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */

package jdk.javadoc.internal.doclets.formats.html.markup;

import java.util.Locale;
import java.util.regex.Pattern;

Enum representing HTML styles, with associated entries in the stylesheet files.
 
This is NOT part of any supported API.
 If you write code that depends on this, you do so at your own risk.
 This code and its internal interfaces are subject to change or
 deletion without notice.
See Also:
API Note:
 Despite the name, the members of this enum provide values for the HTML class attribute, and not the HTML style attribute. This is to avoid confusion with the widespread use of the word "class" in the Java ecosystem, and the potential for clashes with methods called setClass instead of setStyle.
API Note:
 The description of some members refer to "elements". This typically refers to "HTML elements", but may in some cases refer to or "language model elements". The usage is made explicit when it is not clear fromthe surrounding context./**
 * Enum representing HTML styles, with associated entries in the stylesheet files.
 *
 *  <p><b>This is NOT part of any supported API.
 *  If you write code that depends on this, you do so at your own risk.
 *  This code and its internal interfaces are subject to change or
 *  deletion without notice.</b>
 *
 * @apiNote
 * Despite the name, the members of this enum provide values for the HTML {@code class} attribute,
 * and <strong>not</strong> the HTML {@code style} attribute.
 * This is to avoid confusion with the widespread use of the word "class" in the Java ecosystem,
 * and the potential for clashes with methods called {@code setClass} instead of {@code setStyle}.
 *
 * @apiNote
 * The description of some members refer to "elements".
 * This typically refers to "HTML elements", but may in some cases refer to
 * or {@link javax.lang.model.element.Element "language model elements"}.
 * The usage is made explicit when it is not clear fromthe surrounding context.
 *
 * @see <a href="https://html.spec.whatwg.org/#classes>WhatWG: {@code class} attribute</a>
 */
public enum HtmlStyle {
    block,
    blockList,
    circle,
    classUses,
    deprecatedLabel,
    deprecationBlock,
    deprecationComment,
    descfrmTypeLabel,
    externalLink,
    helpFootnote,
    helpSection,
    helpSectionList,
    hierarchy,
    horizontal,
    implementationLabel,
    index,
    inheritance,
    inheritedList,
    interfaceName,
    legalCopy,
    memberNameLabel,
    memberNameLink,
    nameValue,
    packages,
    packageHierarchyLabel,
    packageUses,
    permitsNote,
    searchTagLink,
    searchTagResult,
    serializedPackageContainer,
    sourceContainer,
    sourceLineNo,
    typeNameLabel,
    typeNameLink,
    verticalSeparator,

    //<editor-fold desc="navigation bar">
    //
    // The following constants are used for the main navigation bar that appears in the
    // {@code header} and {@code footer} elements on each page.

    
The class for the overall div element containing the header element for the page. /**
     * The class for the overall {@code div} element containing the {@code header} element for the page.
     */
    topNav,

    
The class for the overall div element containing the footer element for the page. /**
     * The class for the overall {@code div} element containing the {@code footer} element for the page.
     */
    bottomNav,

    
The class for the element containing the information (such as the product name and version) provided by the -header or -footer command line option. /**
     * The class for the element containing the information (such as the product name and version)
     * provided by the {@code -header} or {@code -footer} command line option.
     */
    aboutLanguage,

    
The class for the highlighted item in the list of navigation links, indicating
the current page.
/**
     * The class for the highlighted item in the list of navigation links, indicating
     * the current page.
     */
    // The etymology of the name is a mystery.
    navBarCell1Rev,

    
The class for the primary list of navigation links.
/**
     * The class for the primary list of navigation links.
     */
    navList,

    
The class for the div element containing the "Search" control. /**
     * The class for the {@code div} element containing the "Search" control.
     */
    navListSearch,

    
The class for a div element containing a link to skip the navigation header. The element is typically invisible, but may be used when navigating the page with a screen reader. /**
     * The class for a {@code div} element containing a link to skip the navigation header.
     * The element is typically invisible, but may be used when navigating the page
     * with a screen reader.
     */
    skipNav,

    
The class for a div element containing a list of subsidiary navigation links. /**
     * The class for a {@code div} element containing a list of subsidiary navigation links.
     */
    subNav,

    
The class for the list of subsidiary navigation links.
/**
     * The class for the list of subsidiary navigation links.
     */
    subNavList,

    //</editor-fold>

    //<editor-fold desc="header (title block)">
    //
    // The following constants are used for the main "header" ("heading") that
    // provides the title for the page. This should not be confused with the
    // {@code header} element that contains the top navigation bar.

    
The class for the element that contains all of the main heading for the page.
/**
     * The class for the element that contains all of the main heading for the page.
     */
    header,

    
The class for the "module" label in the heading for a package declaration.
/**
     * The class for the "module" label in the heading for a package declaration.
     */
    moduleLabelInPackage,

    
The class for the "module" label in the heading for a type declaration.
/**
     * The class for the "module" label in the heading for a type declaration.
     */
    moduleLabelInType,

    
The class for the "package" label in the heading for a type declaration.
/**
     * The class for the "package" label in the heading for a type declaration.
     */
    packageLabelInType,

    
The class for the element containing the label and name for the module
or package that precedes the main title for the declaration of a
package or type.
/**
     * The class for the element containing the label and name for the module
     * or package that precedes the main title for the declaration of a
     * package or type.
     */
    subTitle,

    
The class for the element containing the label and name for
the main title on a page for the declaration of a package or type.
/**
     * The class for the element containing the label and name for
     * the main title on a page for the declaration of a package or type.
     */
    title,

    //</editor-fold>

    //<editor-fold desc="summaries">
    //
    // The following constants are used for the HTML elements that provide
    // summary information, either of the program elements enclosed
    // by some program element, or in pages providing aggregate information
    // about similar program elements.
    // As a general rule, summaries are typically displayed as tables,
    // with rows containing the name or signature of an element, and the
    // first sentence of the description of that element. The name or signature
    // is typically linked to a corresponding "Details" section.
    //
    // Note: the "Summary" information on a module declaration page for
    // "Services" would be better characterized as "Details" information,
    // since it contains the full text of the descriptions in the
    // @provides and @uses tags, and not just the first sentence.

    
The class for the overall section element containing all the different kinds of summary for the parts of the program element declared on this page. /**
     * The class for the overall {@code section} element containing all the
     * different kinds of summary for the parts of the program element
     * declared on this page.
     */
    summary,

    
The class for the list element of all the different kinds of summary for the parts of the program element declared on this page. /**
     * The class for the {@code list} element of all the different kinds of
     * summary for the parts of the program element declared on this page.
     */
    summaryList,

    
The class for the section element containing a summary of the constructors for a type. /**
     * The class for the {@code section} element containing a summary of
     * the constructors for a type.
     */
    constructorSummary,

    
The class for a section element containing a summary of the fields of a type. /**
     * The class for a {@code section} element containing a summary of
     * the fields of a type.
     */
    fieldSummary,

    
The class for a section element containing the members of a given kind for a type. /**
     * The class for a {@code section} element containing the members
     * of a given kind for a type.
     */
    memberSummary,

    
The class for the section element containing a summary of the methods of a type. /**
     * The class for the {@code section} element containing a summary of
     * the methods of a type.
     */
    methodSummary,

    
The class for the section element containing a summary of the module dependencies of a module. /**
     * The class for the {@code section} element containing a summary of
     * the module dependencies of a module.
     */
    modulesSummary,

    
The class for the section element containing a summary of the nested classes of a type. /**
     * The class for the {@code section} element containing a summary of
     * the nested classes of a type.
     */
    nestedClassSummary,

    
The class for the section element containing a summary of the packages provided by a module, and
the class for the list of packages on the "All Packages" index page.
/**
     * The class for the {@code section} element containing a summary of
     * the packages provided by a module,
     * <i>and</i>
     * the class for the list of packages on the "All Packages" index page.
     */
    packagesSummary,

    
The class for the section element containing a summary of the properties for a type. /**
     * The class for the {@code section} element containing a summary of
     * the properties for a type.
     */
    propertySummary,

    
The class for the section element containing a summary of the services provided by a module. /**
     * The class for the {@code section} element containing a summary of
     * the services provided by a module.
     */
    providesSummary,

    
The class for the section element containing a summary of the modules required by a module. /**
     * The class for the {@code section} element containing a summary of
     * the modules required by a module.
     */
    requiresSummary,

    
The class for the section element containing a summary of the services provided or used by a module. /**
     * The class for the {@code section} element containing a summary of
     * the services provided or used by a module.
     */
    servicesSummary,

    
The class for the section element containing a summary of the services used by a module. /**
     * The class for the {@code section} element containing a summary of
     * the services used by a module.
     */
    usesSummary,

    
The class for a section element on the "Constants Field Values" page, and the class for the section element for the enum constants of an enum class. /**
     * The class for a {@code section} element on the "Constants Field Values" page,
     * <i>and</i>
     * the class for the {@code section} element for the enum constants of an enum class.
     */
    constantsSummary,

    
The class for a section element on the "Deprecated" page. /**
     * The class for a {@code section} element on the "Deprecated"
     * page.
     */
    deprecatedSummary,

    
The class for the section element on the top-level page summarizing all the modules or packages that are documented. /**
     * The class for the {@code section} element on the top-level page
     * summarizing all the modules or packages that are documented.
     */
    overviewSummary,

    
The class for a section element on the "System Properties" page. /**
     * The class for a {@code section} element on the "System Properties" page.
     */
    systemPropertiesSummary,

    
The class for the list of packages on the "All Packages" index page,
and the class for the section element summarizing the types in a package. /**
     * The class for the list of packages on the "All Packages" index page,
     * <i>and</i>
     * the class for the {@code section} element summarizing the types
     * in a package.
     */
    typeSummary,

    
The class for section elements containing information about where a package, type or member is used within the API. /**
     * The class for {@code section} elements containing information
     * about where a package, type or member is used within the API.
     */
    useSummary,
    //</editor-fold>

    //<editor-fold desc="details">
    //
    // The following constants are used for the details of the enclosed
    // (program) elements of an enclosing element, such as a module,
    // package or type declaration.

    
The class for the overall section element for all the details about enclosed program elements. /**
     * The class for the overall {@code section} element for all the details
     * about enclosed program elements.
     */
    details,

    
The class for the list of sublists containing the details for
the different kinds of program elements.
/**
     * The class for the list of sublists containing the details for
     * the different kinds of program elements.
     */
    detailsList,

    
The class for the section element containing the details for a single enclosed element. /**
     * The class for the {@code section} element containing the details
     * for a single enclosed element.
     */
    detail,

    
The class for the list containing the details for the members
of a given element kind.
/**
     * The class for the list containing the details for the members
     * of a given element kind.
     */
    memberList,

    
The class for the section containing the list of details for all the constructors declared in a type element. /**
     * The class for the {@code section} containing the list of details for
     * all the constructors declared in a type element.
     */
    constructorDetails,

    
The class for the section containing the list of details for all the enum constants declared in a enum element. /**
     * The class for the {@code section} containing the list of details for
     * all the enum constants declared in a enum element.
     */
    constantDetails,

    
The class for the section containing the list of details for all the fields declared in a type element. /**
     * The class for the {@code section} containing the list of details for
     * all the fields declared in a type element.
     */
    fieldDetails,

    
The class for the section containing the list of details for all the members declared in a annotation type element. /**
     * The class for the {@code section} containing the list of details for
     * all the members declared in a annotation type element.
     */
    memberDetails,

    
The class for the section containing the list of details for all the methods declared in a type element. /**
     * The class for the {@code section} containing the list of details for
     * all the methods declared in a type element.
     */
    methodDetails,

    
The class for the section containing the list of details for all the properties declared in a JavaFX type element. /**
     * The class for the {@code section} containing the list of details for
     * all the properties declared in a JavaFX type element.
     */
    propertyDetails,

    
The class for a section element containing details of the serialized form of an element, on the "Serialized Form" page. /**
     * The class for a {@code section} element containing details of the
     * serialized form of an element, on the "Serialized Form" page.
     */
    serializedClassDetails,

    //</editor-fold>

    //<editor-fold desc="tables">
    //
    // The following constants are used for "summary" and "details" tables.
    // Most tables are summary tables, meaning that, in part, they provide links to details elsewhere.
    // A module page has details tables containing the details of the directives.

    
The class of a table element used to present details of a program element. /**
     * The class of a {@code table} element used to present details of a program element.
     */
    detailsTable,

    
The class of a table element used to present a summary of the enclosed elements of a program element. A summaryTable typically references items in a corresponding detailsList. /**
     * The class of a {@code table} element used to present a summary of the enclosed
     * elements of a program element.  A {@code summaryTable} typically references
     * items in a corresponding {@link #detailsList}.
     */
    summaryTable,

    
The class of the "tab" that indicates the currently displayed contents of a table.
This is used when the table provides filtered views.
/**
     * The class of the "tab" that indicates the currently displayed contents of a table.
     * This is used when the table provides filtered views.
     */
    activeTableTab,

    
The class of a "tab" that indicates an alternate view of the contents of a table.
This is used when the table provides filtered views.
/**
     * The class of a "tab" that indicates an alternate view of the contents of a table.
     * This is used when the table provides filtered views.
     */
    tableTab,

    
The class of the div element that contains the tabs used to select the contents of the associated table to be displayed. /**
     * The class of the {@code div} element that contains the tabs used to select
     * the contents of the associated table to be displayed.
     */
    tableTabs,

    
The class of the cells in a table column used to display the name
of a constructor.
/**
     * The class of the cells in a table column used to display the name
     * of a constructor.
     */
    colConstructorName,

    
The class of the cells in a table column used to display the name
of a deprecated item.
/**
     * The class of the cells in a table column used to display the name
     * of a deprecated item.
     */
    colDeprecatedItemName,

    
The class of the first column of cells in a table.
This is typically the "type and modifiers" column, where the type is
the type of a field or the return type of a method.
/**
     * The class of the first column of cells in a table.
     * This is typically the "type and modifiers" column, where the type is
     * the type of a field or the return type of a method.
     */
    colFirst,

    
The class of the last column of cells in a table.
This is typically the "description" column, where the description is
the first sentence of the elemen ts documentation comment.
/**
     * The class of the last column of cells in a table.
     * This is typically the "description" column, where the description is
     * the first sentence of the elemen ts documentation comment.
     */
    colLast,

    
The class of the second column of cells in a table.
This is typically the column that defines the name of a field or the
name and parameters of a method.
/**
     * The class of the second column of cells in a table.
     * This is typically the column that defines the name of a field or the
     * name and parameters of a method.
     */
    colSecond,

    
A class used to provide the background for the rows of a table, to provide a "striped" effect. This class and rowColor are used on alternating rows. The classes are applied dynamically when table "tabs" are used to filter the set of rows to be displayed /**
     * A class used to provide the background for the rows of a table,
     * to provide a "striped" effect. This class and {@link #rowColor}
     * are used on alternating rows.
     * The classes are applied dynamically when table "tabs" are used
     * to filter the set of rows to be displayed
     */
    altColor,

    
A class used to provide the background for the rows of a table, to provide a "striped" effect. This class and altColor are used on alternating rows. The classes are applied dynamically when table "tabs" are used to filter the set of rows to be displayed /**
     * A class used to provide the background for the rows of a table,
     * to provide a "striped" effect. This class and {@link #altColor}
     * are used on alternating rows.
     * The classes are applied dynamically when table "tabs" are used
     * to filter the set of rows to be displayed
     */
    rowColor,
    //</editor-fold>

    //<editor-fold desc="documentation comments">
    //
    // The following constants are used for the components used to present the content
    // generated from documentation comments.

    
The class of the element used to present the documentation comment for a type or member element. The content of the block tags will be in a nested element with class notes. /**
     * The class of the element used to present the documentation comment for a type or member
     * element.
     * The content of the block tags will be in a nested element with class {@link #notes}.
     */
    description,

    
The class of the element used to present the documentation comment for a module element, excluding block tags. The content of the block tags will be in a sibling element with class moduleTags. /**
     * The class of the element used to present the documentation comment for a module element,
     * excluding block tags.
     * The content of the block tags will be in a sibling element with class {@link #moduleTags}.
     */
    moduleDescription,

    
The class of the element used to present the documentation comment for package element. The content of the block tags will be in a nested element with class notes. /**
     * The class of the element used to present the documentation comment for package element.
     * The content of the block tags will be in a nested element with class {@link #notes}.
     */
    packageDescription,

    
The class of the dl element used to present the block tags in the documentation comment for a package, type or member element. Additional (derived) information, such as implementation or inheritance details, may also appear in this element. /**
     * The class of the {@code dl} element used to present the block tags in the documentation
     * comment for a package, type or member element.
     * Additional (derived) information, such as implementation or inheritance details, may
     * also appear in this element.
     */
    notes,
    //</editor-fold>

    //<editor-fold desc="flex layout">
    //
    // The following constants are used for the components of the top-level structures for "flex" layout.

    
The class of the top-level div element used to arrange for "flex" layout in a browser window. The element should contain two child elements: one with class flex-header and one with class flex-content. /**
     * The class of the top-level {@code div} element used to arrange for "flex" layout in
     * a browser window. The element should contain two child elements: one with class
     * {@link #flexHeader flex-header} and one with class {@link #flexContent flex-content}.
     */
    flexBox,

    
The class of the header element within a flex-box container. The element is always displayed at the top of the viewport. /**
     * The class of the {@code header} element within a {@link #flexBox flex-box} container.
     * The element is always displayed at the top of the viewport.
     */
    flexHeader,

    
The class of the div element within a flex-box container This element appears below the header and can be scrolled if too big for the available height. /**
     * The class of the {@code div} element within a {@link #flexBox flex-box} container
     * This element appears below the header and can be scrolled if too big for the available height.
     */
    flexContent,
    //</editor-fold>

    //<editor-fold desc="member signature">
    //
    // The following constants are used for the components of a signature of an element

    
The class of a span element for the signature of an element. The signature will contain a member name and, depending on the kind of element, it can contain any of the following: annotations, type parameters, modifiers, return type, parameters, and exceptions. /**
     * The class of a {@code span} element for the signature of an element.
     * The signature will contain a member name and, depending on the kind of element,
     * it can contain any of the following:
     * annotations, type parameters, modifiers, return type, parameters, and exceptions.
     */
    memberSignature,

    
The class of a span element for any annotations in the signature of an element. /**
     * The class of a {@code span} element for any annotations in the signature of an element.
     */
    annotations,

    
The class of a span element for any exceptions in a signature of an executable element. /**
     * The class of a {@code span} element for any exceptions in a signature of an executable element.
     */
    exceptions,

    
The class of a span for the member name in the signature of an element. /**
     * The class of a {@code span} for the member name in the signature of an element.
     */
    memberName,

    
The class of a span for any modifiers in the signature of an element. /**
     * The class of a {@code span} for any modifiers in the signature of an element.
     */
    modifiers,

    
The class of a span for any parameters in the signature of an executable element. /**
     * The class of a {@code span} for any parameters in the signature of an executable element.
     */
    parameters,

    
The class of a span for the return type in the signature of an method element. /**
     * The class of a {@code span} for the return type in the signature of an method element.
     */
    returnType,

    
The class of a span for type parameters in the signature of an element, used when the type parameters should reasonably be displayed inline. /**
     * The class of a {@code span} for type parameters in the signature of an element,
     * used when the type parameters should reasonably be displayed inline.
     */
    typeParameters,

    
The class of a span for type parameters in the signature of an element, used when the type parameters are too long to be displayed inline. 
Implementation Note:
 The threshold for choosing between typeParameters and typeParametersLong is 50 characters./**
     * The class of a {@code span} for type parameters in the signature of an element,
     * used when the type parameters are too long to be displayed inline.
     * @implNote
     * The threshold for choosing between {@code typeParameters} and {@code typeParametersLong}
     * is 50 characters.
     */
    typeParametersLong,
    //</editor-fold>

    //<editor-fold desc="page styles for <body> elements">
    //
    // The following constants are used for the class of the {@code <body>} element
    // for the corresponding pages.

    
The class of the body element for the "All Classes" index page. /**
     * The class of the {@code body} element for the "All Classes" index page.
     */
    allClassesIndexPage,

    
The class of the body element for the "All Packages" index page. /**
     * The class of the {@code body} element for the "All Packages" index page.
     */
    allPackagesIndexPage,

    
The class of the body element for a class-declaration page. /**
     * The class of the {@code body} element for a class-declaration page.
     */
    classDeclarationPage,

    
The class of the body element for a class-use page. /**
     * The class of the {@code body} element for a class-use page.
     */
    classUsePage,

    
The class of the body element for the constants-summary page. /**
     * The class of the {@code body} element for the constants-summary page.
     */
    constantsSummaryPage,

    
The class of the body element for the page listing any deprecated items. /**
     * The class of the {@code body} element for the page listing any deprecated items.
     */
    deprecatedListPage,

    
The class of the body element for a "doc-file" page.. /**
     * The class of the {@code body} element for a "doc-file" page..
     */
    docFilePage,

    
The class of the body element for the "help" page. /**
     * The class of the {@code body} element for the "help" page.
     */
    helpPage,

    
The class of the body element for the top-level redirect page. /**
     * The class of the {@code body} element for the top-level redirect page.
     */
    indexRedirectPage,

    
The class of the body element for a module-declaration page. /**
     * The class of the {@code body} element for a module-declaration page.
     */
    moduleDeclarationPage,

    
The class of the body element for the module-index page. /**
     * The class of the {@code body} element for the module-index page.
     */
    moduleIndexPage,

    
The class of the body element for a package-declaration page. /**
     * The class of the {@code body} element for a package-declaration page.
     */
    packageDeclarationPage,

    
The class of the body element for the package-index page. /**
     * The class of the {@code body} element for the package-index page.
     */
    packageIndexPage,

    
The class of the body element for the page for the package hierarchy. /**
     * The class of the {@code body} element for the page for the package hierarchy.
     */
    packageTreePage,

    
The class of the body element for a package-use page. /**
     * The class of the {@code body} element for a package-use page.
     */
    packageUsePage,

    
The class of the body element for the serialized-forms page. /**
     * The class of the {@code body} element for the serialized-forms page.
     */
    serializedFormPage,

    
The class of the body element for the full single index page. /**
     * The class of the {@code body} element for the full single index page.
     */
    singleIndexPage,

    
The class of the body element for a page with the source code for a class. /**
     * The class of the {@code body} element for a page with the source code for a class.
     */
    sourcePage,

    
The class of the body element for a page in a "split index". /**
     * The class of the {@code body} element for a page in a "split index".
     */
    splitIndexPage,

    
The class of the body element for the system-properties page. /**
     * The class of the {@code body} element for the system-properties page.
     */
    systemPropertiesPage,

    
The class of the body element for the page for the class hierarchy. /**
     * The class of the {@code body} element for the page for the class hierarchy.
     */
    treePage;
    //</editor-fold>

    private final String cssName;

    HtmlStyle() {
        cssName = Pattern.compile("\\p{Upper}")
                .matcher(toString())
                .replaceAll(mr -> "-" + mr.group().toLowerCase(Locale.US));
    }

    HtmlStyle(String cssName) {
        this.cssName = cssName;
    }

    
Returns the CSS class name associated with this style.
Returns:
the CSS class name/**
     * Returns the CSS class name associated with this style.
     * @return the CSS class name
     */
    public String cssName() {
        return cssName;
    }
}