@ahmttyydn/java-integration 1.0.1

package/scalar-core/src/main/java/com/scalar/maven/core/enums/ScalarTheme.java

@@ -0,0 +1,102 @@
+package com.scalar.maven.core.enums;
+
+import com.fasterxml.jackson.annotation.JsonCreator;
+import com.fasterxml.jackson.annotation.JsonValue;
+
+/**
+ * Represents the different themes available in Scalar.
+ */
+public enum ScalarTheme {
+    /**
+     * No theme applied.
+     */
+    NONE("none"),
+
+    /**
+     * Alternate theme.
+     */
+    ALTERNATE("alternate"),
+
+    /**
+     * Default theme.
+     */
+    DEFAULT("default"),
+
+    /**
+     * Moon theme.
+     */
+    MOON("moon"),
+
+    /**
+     * Purple theme.
+     */
+    PURPLE("purple"),
+
+    /**
+     * Solarized theme.
+     */
+    SOLARIZED("solarized"),
+
+    /**
+     * Blue Planet theme.
+     */
+    BLUE_PLANET("bluePlanet"),
+
+    /**
+     * Saturn theme.
+     */
+    SATURN("saturn"),
+
+    /**
+     * Kepler theme.
+     */
+    KEPLER("kepler"),
+
+    /**
+     * Mars theme.
+     */
+    MARS("mars"),
+
+    /**
+     * Deep Space theme.
+     */
+    DEEP_SPACE("deepSpace"),
+
+    /**
+     * Laserwave theme.
+     */
+    LASERWAVE("laserwave");
+
+    private final String value;
+
+    ScalarTheme(String value) {
+        this.value = value;
+    }
+
+    /**
+     * Creates a ScalarTheme from a string value.
+     *
+     * @param value the string value
+     * @return the corresponding ScalarTheme
+     * @throws IllegalArgumentException if the value is not recognized
+     */
+    @JsonCreator
+    public static ScalarTheme fromValue(String value) {
+        for (ScalarTheme theme : values()) {
+            if (theme.value.equals(value)) {
+                return theme;
+            }
+        }
+        throw new IllegalArgumentException("Unknown theme: " + value);
+    }
+
+    /**
+     * Gets the string value for JSON serialization.
+     *
+     * @return the string value
+     */
+    @JsonValue
+    public String getValue() {
+        return value;
+    }
+}

package/scalar-core/src/main/java/com/scalar/maven/core/enums/TagSorter.java

@@ -0,0 +1,47 @@
+package com.scalar.maven.core.enums;
+
+import com.fasterxml.jackson.annotation.JsonCreator;
+import com.fasterxml.jackson.annotation.JsonValue;
+
+/**
+ * Represents the sorting method for tags in the Scalar API Reference.
+ */
+public enum TagSorter {
+    /**
+     * Sort tags alphabetically.
+     */
+    ALPHA("alpha");
+
+    private final String value;
+
+    TagSorter(String value) {
+        this.value = value;
+    }
+
+    /**
+     * Creates a TagSorter from a string value.
+     *
+     * @param value the string value
+     * @return the corresponding TagSorter
+     * @throws IllegalArgumentException if the value is not recognized
+     */
+    @JsonCreator
+    public static TagSorter fromValue(String value) {
+        for (TagSorter sorter : values()) {
+            if (sorter.value.equals(value)) {
+                return sorter;
+            }
+        }
+        throw new IllegalArgumentException("Unknown tag sorter: " + value);
+    }
+
+    /**
+     * Gets the string value for JSON serialization.
+     *
+     * @return the string value
+     */
+    @JsonValue
+    public String getValue() {
+        return value;
+    }
+}

package/scalar-core/src/main/java/com/scalar/maven/core/enums/ThemeMode.java

@@ -0,0 +1,52 @@
+package com.scalar.maven.core.enums;
+
+import com.fasterxml.jackson.annotation.JsonCreator;
+import com.fasterxml.jackson.annotation.JsonValue;
+
+/**
+ * Represents the theme mode for the Scalar API Reference.
+ */
+public enum ThemeMode {
+    /**
+     * Light theme mode.
+     */
+    LIGHT("light"),
+
+    /**
+     * Dark theme mode.
+     */
+    DARK("dark");
+
+    private final String value;
+
+    ThemeMode(String value) {
+        this.value = value;
+    }
+
+    /**
+     * Creates a ThemeMode from a string value.
+     *
+     * @param value the string value
+     * @return the corresponding ThemeMode
+     * @throws IllegalArgumentException if the value is not recognized
+     */
+    @JsonCreator
+    public static ThemeMode fromValue(String value) {
+        for (ThemeMode mode : values()) {
+            if (mode.value.equals(value)) {
+                return mode;
+            }
+        }
+        throw new IllegalArgumentException("Unknown theme mode: " + value);
+    }
+
+    /**
+     * Gets the string value for JSON serialization.
+     *
+     * @return the string value
+     */
+    @JsonValue
+    public String getValue() {
+        return value;
+    }
+}

package/scalar-core/src/main/java/com/scalar/maven/core/internal/ScalarConfiguration.java

@@ -0,0 +1,425 @@
+package com.scalar.maven.core.internal;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.scalar.maven.core.authentication.ScalarAuthenticationOptions;
+import com.scalar.maven.core.config.DefaultHttpClient;
+import com.scalar.maven.core.config.ScalarAgentOptions;
+import com.scalar.maven.core.config.ScalarServer;
+import com.scalar.maven.core.config.ScalarSource;
+import com.scalar.maven.core.enums.*;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * Internal representation of the configuration for the Scalar API Reference.
+ * <p>
+ * <strong>Warning:</strong> This class is internal API and should not be used
+ * directly.
+ * It may change without notice in future versions. Use
+ * {@link com.scalar.maven.core.ScalarProperties} instead.
+ * </p>
+ * Based on <a href=
+ * "https://github.com/scalar/scalar/blob/main/documentation/configuration.md">Configuration</a>.
+ */
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class ScalarConfiguration {
+
+    @JsonProperty("url")
+    private String url;
+
+    @JsonProperty("proxyUrl")
+    private String proxyUrl;
+
+    @JsonProperty("showSidebar")
+    private Boolean showSidebar;
+
+    @JsonProperty("operationTitleSource")
+    private OperationTitleSource operationTitleSource;
+
+    @JsonProperty("hideModels")
+    private Boolean hideModels;
+
+    @JsonProperty("hideTestRequestButton")
+    private Boolean hideTestRequestButton;
+
+    @JsonProperty("darkMode")
+    private Boolean darkMode;
+
+    @JsonProperty("forceDarkModeState")
+    private ThemeMode forceDarkModeState;
+
+    @JsonProperty("hideDarkModeToggle")
+    private Boolean hideDarkModeToggle;
+
+    @JsonProperty("customCss")
+    private String customCss;
+
+    @JsonProperty("searchHotKey")
+    private String searchHotKey;
+
+    @JsonProperty("servers")
+    private List<ScalarServer> servers;
+
+    @JsonProperty("metaData")
+    private Map<String, String> metaData;
+
+    @JsonProperty("defaultHttpClient")
+    private DefaultHttpClient defaultHttpClient;
+
+    @JsonProperty("authentication")
+    private ScalarAuthenticationOptions authentication;
+
+    @JsonProperty("withDefaultFonts")
+    private Boolean withDefaultFonts;
+
+    @JsonProperty("defaultOpenAllTags")
+    private Boolean defaultOpenAllTags;
+
+    @JsonProperty("expandAllModelSections")
+    private Boolean expandAllModelSections;
+
+    @JsonProperty("expandAllResponses")
+    private Boolean expandAllResponses;
+
+    @JsonProperty("hideSearch")
+    private Boolean hideSearch;
+
+    @JsonProperty("tagsSorter")
+    private TagSorter tagSorter;
+
+    @JsonProperty("operationsSorter")
+    private OperationSorter operationsSorter;
+
+    @JsonProperty("theme")
+    private ScalarTheme theme;
+
+    @JsonProperty("layout")
+    private ScalarLayout layout;
+
+    @JsonProperty("favicon")
+    private String favicon;
+
+    @JsonProperty("hideClientButton")
+    private Boolean hideClientButton;
+
+    @JsonProperty("sources")
+    private List<ScalarSource> sources;
+
+    @JsonProperty("baseServerURL")
+    private String baseServerUrl;
+
+    @JsonProperty("persistAuth")
+    private Boolean persistAuth;
+
+    @JsonProperty("telemetry")
+    private Boolean telemetry;
+
+    @JsonProperty("documentDownloadType")
+    private DocumentDownloadType documentDownloadType;
+
+    @JsonProperty("orderRequiredPropertiesFirst")
+    private Boolean orderRequiredPropertiesFirst;
+
+    @JsonProperty("orderSchemaPropertiesBy")
+    private PropertyOrder orderSchemaPropertiesBy;
+
+    @JsonProperty("showOperationId")
+    private Boolean showOperationId;
+
+    @JsonProperty("showDeveloperTools")
+    private DeveloperToolsVisibility showDeveloperTools;
+
+    @JsonProperty("agent")
+    private ScalarAgentOptions agent;
+
+    // Getters and setters
+    public String getUrl() {
+        return url;
+    }
+
+    public void setUrl(String url) {
+        this.url = url;
+    }
+
+    public String getProxyUrl() {
+        return proxyUrl;
+    }
+
+    public void setProxyUrl(String proxyUrl) {
+        this.proxyUrl = proxyUrl;
+    }
+
+    public Boolean getShowSidebar() {
+        return showSidebar;
+    }
+
+    public void setShowSidebar(Boolean showSidebar) {
+        this.showSidebar = showSidebar;
+    }
+
+    public OperationTitleSource getOperationTitleSource() {
+        return operationTitleSource;
+    }
+
+    public void setOperationTitleSource(OperationTitleSource operationTitleSource) {
+        this.operationTitleSource = operationTitleSource;
+    }
+
+    public Boolean getHideModels() {
+        return hideModels;
+    }
+
+    public void setHideModels(Boolean hideModels) {
+        this.hideModels = hideModels;
+    }
+
+    public Boolean getHideTestRequestButton() {
+        return hideTestRequestButton;
+    }
+
+    public void setHideTestRequestButton(Boolean hideTestRequestButton) {
+        this.hideTestRequestButton = hideTestRequestButton;
+    }
+
+    public Boolean getDarkMode() {
+        return darkMode;
+    }
+
+    public void setDarkMode(Boolean darkMode) {
+        this.darkMode = darkMode;
+    }
+
+    public ThemeMode getForceDarkModeState() {
+        return forceDarkModeState;
+    }
+
+    public void setForceDarkModeState(ThemeMode forceDarkModeState) {
+        this.forceDarkModeState = forceDarkModeState;
+    }
+
+    public Boolean getHideDarkModeToggle() {
+        return hideDarkModeToggle;
+    }
+
+    public void setHideDarkModeToggle(Boolean hideDarkModeToggle) {
+        this.hideDarkModeToggle = hideDarkModeToggle;
+    }
+
+    public String getCustomCss() {
+        return customCss;
+    }
+
+    public void setCustomCss(String customCss) {
+        this.customCss = customCss;
+    }
+
+    public String getSearchHotKey() {
+        return searchHotKey;
+    }
+
+    public void setSearchHotKey(String searchHotKey) {
+        this.searchHotKey = searchHotKey;
+    }
+
+    public List<ScalarServer> getServers() {
+        return servers;
+    }
+
+    public void setServers(List<ScalarServer> servers) {
+        this.servers = servers;
+    }
+
+    public Map<String, String> getMetaData() {
+        return metaData;
+    }
+
+    public void setMetaData(Map<String, String> metaData) {
+        this.metaData = metaData;
+    }
+
+    public DefaultHttpClient getDefaultHttpClient() {
+        return defaultHttpClient;
+    }
+
+    public void setDefaultHttpClient(DefaultHttpClient defaultHttpClient) {
+        this.defaultHttpClient = defaultHttpClient;
+    }
+
+    public ScalarAuthenticationOptions getAuthentication() {
+        return authentication;
+    }
+
+    public void setAuthentication(ScalarAuthenticationOptions authentication) {
+        this.authentication = authentication;
+    }
+
+    public Boolean getWithDefaultFonts() {
+        return withDefaultFonts;
+    }
+
+    public void setWithDefaultFonts(Boolean withDefaultFonts) {
+        this.withDefaultFonts = withDefaultFonts;
+    }
+
+    public Boolean getDefaultOpenAllTags() {
+        return defaultOpenAllTags;
+    }
+
+    public void setDefaultOpenAllTags(Boolean defaultOpenAllTags) {
+        this.defaultOpenAllTags = defaultOpenAllTags;
+    }
+
+    public Boolean getExpandAllModelSections() {
+        return expandAllModelSections;
+    }
+
+    public void setExpandAllModelSections(Boolean expandAllModelSections) {
+        this.expandAllModelSections = expandAllModelSections;
+    }
+
+    public Boolean getExpandAllResponses() {
+        return expandAllResponses;
+    }
+
+    public void setExpandAllResponses(Boolean expandAllResponses) {
+        this.expandAllResponses = expandAllResponses;
+    }
+
+    public Boolean getHideSearch() {
+        return hideSearch;
+    }
+
+    public void setHideSearch(Boolean hideSearch) {
+        this.hideSearch = hideSearch;
+    }
+
+    public TagSorter getTagSorter() {
+        return tagSorter;
+    }
+
+    public void setTagSorter(TagSorter tagSorter) {
+        this.tagSorter = tagSorter;
+    }
+
+    public OperationSorter getOperationsSorter() {
+        return operationsSorter;
+    }
+
+    public void setOperationsSorter(OperationSorter operationsSorter) {
+        this.operationsSorter = operationsSorter;
+    }
+
+    public ScalarTheme getTheme() {
+        return theme;
+    }
+
+    public void setTheme(ScalarTheme theme) {
+        this.theme = theme;
+    }
+
+    public ScalarLayout getLayout() {
+        return layout;
+    }
+
+    public void setLayout(ScalarLayout layout) {
+        this.layout = layout;
+    }
+
+    public String getFavicon() {
+        return favicon;
+    }
+
+    public void setFavicon(String favicon) {
+        this.favicon = favicon;
+    }
+
+    public Boolean getHideClientButton() {
+        return hideClientButton;
+    }
+
+    public void setHideClientButton(Boolean hideClientButton) {
+        this.hideClientButton = hideClientButton;
+    }
+
+    public List<ScalarSource> getSources() {
+        return sources;
+    }
+
+    public void setSources(List<ScalarSource> sources) {
+        this.sources = sources;
+    }
+
+    public String getBaseServerUrl() {
+        return baseServerUrl;
+    }
+
+    public void setBaseServerUrl(String baseServerUrl) {
+        this.baseServerUrl = baseServerUrl;
+    }
+
+    public Boolean getPersistAuth() {
+        return persistAuth;
+    }
+
+    public void setPersistAuth(Boolean persistAuth) {
+        this.persistAuth = persistAuth;
+    }
+
+    public Boolean getTelemetry() {
+        return telemetry;
+    }
+
+    public void setTelemetry(Boolean telemetry) {
+        this.telemetry = telemetry;
+    }
+
+    public DocumentDownloadType getDocumentDownloadType() {
+        return documentDownloadType;
+    }
+
+    public void setDocumentDownloadType(DocumentDownloadType documentDownloadType) {
+        this.documentDownloadType = documentDownloadType;
+    }
+
+    public Boolean getOrderRequiredPropertiesFirst() {
+        return orderRequiredPropertiesFirst;
+    }
+
+    public void setOrderRequiredPropertiesFirst(Boolean orderRequiredPropertiesFirst) {
+        this.orderRequiredPropertiesFirst = orderRequiredPropertiesFirst;
+    }
+
+    public PropertyOrder getOrderSchemaPropertiesBy() {
+        return orderSchemaPropertiesBy;
+    }
+
+    public void setOrderSchemaPropertiesBy(PropertyOrder orderSchemaPropertiesBy) {
+        this.orderSchemaPropertiesBy = orderSchemaPropertiesBy;
+    }
+
+    public Boolean getShowOperationId() {
+        return showOperationId;
+    }
+
+    public void setShowOperationId(Boolean showOperationId) {
+        this.showOperationId = showOperationId;
+    }
+
+    public DeveloperToolsVisibility getShowDeveloperTools() {
+        return showDeveloperTools;
+    }
+
+    public void setShowDeveloperTools(DeveloperToolsVisibility showDeveloperTools) {
+        this.showDeveloperTools = showDeveloperTools;
+    }
+
+    public ScalarAgentOptions getAgent() {
+        return agent;
+    }
+
+    public void setAgent(ScalarAgentOptions agent) {
+        this.agent = agent;
+    }
+}

package/scalar-core/src/main/java/com/scalar/maven/core/internal/ScalarConfigurationMapper.java

@@ -0,0 +1,69 @@
+package com.scalar.maven.core.internal;
+
+import com.scalar.maven.core.ScalarProperties;
+
+/**
+ * Mapper class to convert ScalarProperties to ScalarConfiguration for JSON
+ * serialization.
+ * <p>
+ * <strong>Warning:</strong> This class is internal API and should not be used
+ * directly.
+ * It may change without notice in future versions.
+ * </p>
+ */
+public class ScalarConfigurationMapper {
+
+    private ScalarConfigurationMapper() {
+    }
+
+
+    /**
+     * Maps ScalarProperties to ScalarConfiguration.
+     *
+     * @param properties the ScalarProperties to map
+     * @return the mapped ScalarConfiguration
+     */
+    public static ScalarConfiguration map(ScalarProperties properties) {
+        ScalarConfiguration config = new ScalarConfiguration();
+
+        // Basic properties
+        config.setUrl(properties.getUrl());
+        config.setProxyUrl(properties.getProxyUrl());
+        config.setShowSidebar(properties.isShowSidebar());
+        config.setHideModels(properties.isHideModels());
+        config.setHideTestRequestButton(properties.isHideTestRequestButton());
+        config.setDarkMode(properties.isDarkMode());
+        config.setHideDarkModeToggle(properties.isHideDarkModeToggle());
+        config.setCustomCss(properties.getCustomCss());
+        config.setSearchHotKey(properties.getSearchHotKey());
+        config.setServers(properties.getServers());
+        config.setMetaData(properties.getMetadata());
+        config.setDefaultHttpClient(properties.getDefaultHttpClient());
+        config.setAuthentication(properties.getAuthentication());
+        config.setWithDefaultFonts(properties.isWithDefaultFonts());
+        config.setDefaultOpenAllTags(properties.isDefaultOpenAllTags());
+        config.setExpandAllModelSections(properties.isExpandAllModelSections());
+        config.setExpandAllResponses(properties.isExpandAllResponses());
+        config.setHideSearch(properties.isHideSearch());
+        config.setFavicon(properties.getFavicon());
+        config.setHideClientButton(properties.isHideClientButton());
+        config.setSources(properties.getSources());
+        config.setBaseServerUrl(properties.getBaseServerUrl());
+        config.setPersistAuth(properties.isPersistAuth());
+        config.setTelemetry(properties.isTelemetry());
+        config.setOrderRequiredPropertiesFirst(properties.isOrderRequiredPropertiesFirst());
+        config.setShowOperationId(properties.isShowOperationId());
+        config.setTheme(properties.getTheme());
+        config.setLayout(properties.getLayout());
+        config.setDocumentDownloadType(properties.getDocumentDownloadType());
+        config.setOperationTitleSource(properties.getOperationTitleSource());
+        config.setTagSorter(properties.getTagSorter());
+        config.setOperationsSorter(properties.getOperationSorter());
+        config.setForceDarkModeState(properties.getForceThemeMode());
+        config.setOrderSchemaPropertiesBy(properties.getSchemaPropertyOrder());
+        config.setShowDeveloperTools(properties.getShowDeveloperTools());
+        config.setAgent(properties.getAgent());
+
+        return config;
+    }
+}

package/scalar-core/src/main/resources/META-INF/resources/webjars/scalar/index.html

@@ -0,0 +1,22 @@
+<!doctype html>
+<html>
+  <head>
+    <title>__PAGE_TITLE__</title>
+    <meta charset="utf-8" />
+    <meta
+      content="width=device-width, initial-scale=1"
+      name="viewport" />
+  </head>
+
+  <body>
+    <div id="app"></div>
+
+    <!-- Load the Script -->
+    <script src="__JS_BUNDLE_URL__"></script>
+
+    <!-- Initialize the Scalar API Reference -->
+    <script>
+      Scalar.createApiReference('#app', __CONFIGURATION__)
+    </script>
+  </body>
+</html>