package Torello.JavaDoc;

import java.util.*;
import java.util.function.*;

import Torello.Java.ReadOnly.ReadOnlyMap;
import Torello.Java.ReadOnly.ReadOnlyList;

import Torello.HTML.HTMLNode;
import Torello.HTML.TagNodeIndex;
import Torello.HTML.DotPair;

import Torello.Java.Additional.Ret6;

import Torello.Java.Build.BuildPackage;

import Torello.JDUInternal.SimpleFeatures.LinksChecker;

import Torello.JDUInternal.Parse.Java.JSCF.JavaSourceCodeFile;
import Torello.JDUInternal.Parse.HTML.TheREFL.D1_PrimaryRefl;

import com.sun.source.tree.MethodTree;
import com.sun.source.tree.VariableTree;
import com.sun.source.tree.ClassTree;

/**
 * IMPORTANT NOTE: Have a "rocket science" moment, and accept that all this is doing is
 * facilitating the "preservation" of the PACKAGE-PRIVATE levels of privacy on these methods,
 * fields and constructors after "The Big Move"
 * 
 * <BR /><BR />
 * Note that "The Big Move" was putting all of the classes that were deemed "HTML Processors" to
 * sub-directories &amp; sub-packages.  Primary User-API classes (such as "JavaDocHTMLFile" and
 * others like "ReflHTML") are still in the main-directory / main-package.
 * 
 * <BR /><BR />
 * The only two options were to make all of these methods, fields and constructors public or to
 * create this portal class!!
 * 
 * <BR /><BR />
 * The reason keeping these methods, fields &amp; constructors package-private is that once this
 * the Upgrader is truly finished, "The API" that users see should make sense, and they shouldn't
 * be bothered with internal coding/logic decisions that they aren't supposed to use. 
 * 
 * <BR /><BR />
 * The stuff "exported" below are used by the sub-packages, which are not exported to the API at
 * all.  The end user doesn't need to know a thing about any of these.  <B>YES</B> it would be easy
 * to cheat using these, but there is no point.  The "readability" of the classes that are listed
 * above is still preserved.  Knock yourself out, there would be no point...
 * 
 * <BR /><BR />
 * All "Details Sections" in this class have been removed.
 */
@StaticFunctional
public class EXPORT_PORTAL
{
    private EXPORT_PORTAL() { }


    // ********************************************************************************************
    // ********************************************************************************************
    // Declaration
    // ********************************************************************************************
    // ********************************************************************************************


    // INVOKED:  HiLiteDetails
    public static String Declaration$codeHiLiteString(final Declaration d)
    { return d.codeHiLiteString(); }


    // ********************************************************************************************
    // ********************************************************************************************
    // JavaDocHTMLFile
    // ********************************************************************************************
    // ********************************************************************************************


    // INVOKED:  MainFilesProcessor.PART_TWO_Do_The_Rest
    public static void JavaDocHTMLFile$commitChanges(final JavaDocHTMLFile jdhf)
    { jdhf.commitChanges(); }

    // INVOKED: MainFilesProcessor.PART_TWO_Do_The_Rest
    public static Hashtable<String, Integer> JavaDocHTMLFile$checkValidity
        (final JavaDocHTMLFile jdhf)
    { return jdhf.checkValidity(); }

    // INVOKED: MainFilesProcessor.PART_TWO_Do_The_Rest
    public static void JavaDocHTMLFile$commitFileToDisk(final JavaDocHTMLFile jdhf)
        throws java.io.IOException
    { jdhf.commitFileToDisk();  }


    // ********************************************************************************************
    // ********************************************************************************************
    // SummaryTableHTML
    // ********************************************************************************************
    // ********************************************************************************************


    // INVOKED: RearrangeEntitySummaries
    public static <ENTITY extends Declaration> void SummaryTableHTML$setTableRows(
        final SummaryTableHTML<ENTITY>      stHTML,
            final Vector<Vector<HTMLNode>>  tableRows,
            final Vector<ENTITY>            rowEntities
        )
    { stHTML.setTableRows(tableRows, rowEntities); }

    // INVOKED: CleanSummaries, RearrangeEntitySummaries
    public static Vector<HTMLNode> SummaryTableHTML$headerRow(final SummaryTableHTML<?> stHTML)
    { return stHTML.headerRow; }

    // INVOKED: CSSTagsTopAndSumm
    public static TagNodeIndex SummaryTableHTML$openingCinzelH3 (final SummaryTableHTML<?> stHTML)
    { return stHTML.openingCinzelH3; }


    // ********************************************************************************************
    // ********************************************************************************************
    // PackageSummaryHTML
    // ********************************************************************************************
    // ********************************************************************************************


    // INVOKED: Uranus
    // public static Torello.JDUInternal.Features.SORT_TYPES_FRAMES_SUMMARIES.D1_PkgSort
    //     PackageSummaryHTML$sorter(final PackageSummaryHTML psHTML)
    // { return psHTML.sorter(); }


    // ********************************************************************************************
    // ********************************************************************************************
    // Upgrade
    // ********************************************************************************************
    // ********************************************************************************************


    public static void Upgrade$registerEliminatedBuildPackages(
            final Upgrade                       upgrade,
            final ReadOnlyList<BuildPackage>    eliminatedBuildPackages
        )
    { upgrade.registerEliminatedBuildPackages(eliminatedBuildPackages); }

}