cddl2java 0.0.0

package/src/templates.ts

@@ -0,0 +1,258 @@
+/**
+ * Java code templates for WebDriver BiDi Java code generation
+ */
+
+export const emptyResultTemplate: string = `package org.openqa.selenium.bidirectional;
+
+/**
+ * Represents an empty result from a WebDriver BiDi command
+ */
+public class EmptyResult {
+    /**
+     * Creates a new EmptyResult instance
+     */
+    public EmptyResult() {
+        // Empty result has no properties
+    }
+}
+`;
+
+export const contextValueTemplate: string = `package org.openqa.selenium.bidirectional;
+
+import java.util.Map;
+import java.util.HashMap;
+
+/**
+ * Represents a value with context in WebDriver BiDi protocol
+ */
+public class ContextValue {
+    private final String context;
+    private final Map<String, Object> additionalProperties = new HashMap<>();
+
+    /**
+     * Creates a new ContextValue instance
+     * @param context The context ID (typically a browsing context ID)
+     */
+    public ContextValue(String context) {
+        this.context = context;
+    }
+
+    /**
+     * Gets the context property
+     * @return Context ID value
+     */
+    public String getContext() {
+        return context;
+    }
+
+    /**
+     * Adds an additional property to this value
+     * @param key Property name
+     * @param value Property value
+     */
+    public void addProperty(String key, Object value) {
+        additionalProperties.put(key, value);
+    }
+
+    /**
+     * Converts this object to a map for use with BiDi protocol
+     * @return Map representation of this object
+     */
+    public Map<String, Object> asMap() {
+        Map<String, Object> result = new HashMap<>(additionalProperties);
+        result.put("context", context);
+        return result;
+    }
+}`;
+
+export const accessibilityValueTemplate: string = `package org.openqa.selenium.bidirectional;
+
+import java.util.Map;
+import java.util.HashMap;
+
+/**
+ * Represents a value with accessibility properties in WebDriver BiDi protocol
+ */
+public class AccessibilityValue {
+    private final String name;
+    private final String role;
+    private final Map<String, Object> additionalProperties = new HashMap<>();
+
+    /**
+     * Creates a new AccessibilityValue instance
+     * @param name The accessible name
+     * @param role The accessible role
+     */
+    public AccessibilityValue(String name, String role) {
+        this.name = name;
+        this.role = role;
+    }
+
+    /**
+     * Gets the name property
+     * @return Name value
+     */
+    public String getName() {
+        return name;
+    }
+
+    /**
+     * Gets the role property
+     * @return Role value
+     */
+    public String getRole() {
+        return role;
+    }
+
+    /**
+     * Adds an additional property to this value
+     * @param key Property name
+     * @param value Property value
+     */
+    public void addProperty(String key, Object value) {
+        additionalProperties.put(key, value);
+    }
+
+    /**
+     * Converts this object to a map for use with BiDi protocol
+     * @return Map representation of this object
+     */
+    public Map<String, Object> asMap() {
+        Map<String, Object> result = new HashMap<>(additionalProperties);
+        if (name != null) {
+            result.put("name", name);
+        }
+        if (role != null) {
+            result.put("role", role);
+        }
+        return result;
+    }
+}`;
+
+export const getEnumTemplate = (name: string, enums: string[]) => {
+    return `/**
+ * Represents ${name} in WebDriver BiDi protocol
+ * as enum of "${enums.join('" / "')}"
+ */
+public enum ${name} {
+    ${enums.map((e) => {
+        if (e.includes('.')) {
+            const [, prop] = e.split('.')
+            return `${prop.toUpperCase()}(${prop}.class);`
+        }
+        if (e.startsWith('-')) {
+            return `NEGATIVE_${e.slice(1).toUpperCase()}("${e}");`
+        }
+        return `${e.toUpperCase()}("${e}");`
+    }).join('\n    ')}
+
+    private final String value;
+
+    ${name}(String value) {
+        this.value = value;
+    }
+
+    public String getValue() {
+        return value;
+    }
+
+    public static ${name} fromString(String text) {
+        for (${name} ${name.toLowerCase()} : ${name}.values()) {
+            if (${name.toLowerCase()}.value.equalsIgnoreCase(text)) {
+                return ${name.toLowerCase()};
+            }
+        }
+        throw new IllegalArgumentException("No ${name} with value: " + text);
+    }
+}`
+}
+
+export const capabilitiesTemplate: string = `package org.openqa.selenium.bidirectional.session;
+
+import java.util.Map;
+import java.util.HashMap;
+
+/**
+ * Represents browser capabilities in WebDriver BiDi protocol
+ */
+public class Capabilities {
+    private final Map<String, Object> capabilities;
+
+    public Capabilities(Map<String, Object> capabilities) {
+        this.capabilities = capabilities != null ? capabilities : new HashMap<>();
+    }
+
+    public Boolean getAcceptInsecureCerts() {
+        return (Boolean) capabilities.get("acceptInsecureCerts");
+    }
+
+    public String getBrowserName() {
+        return (String) capabilities.get("browserName");
+    }
+
+    public String getBrowserVersion() {
+        return (String) capabilities.get("browserVersion");
+    }
+
+    public String getPlatformName() {
+        return (String) capabilities.get("platformName");
+    }
+
+    public Boolean getSetWindowRect() {
+        return (Boolean) capabilities.get("setWindowRect");
+    }
+
+    public String getUserAgent() {
+        return (String) capabilities.get("userAgent");
+    }
+
+    public String getWebSocketUrl() {
+        return (String) capabilities.get("webSocketUrl");
+    }
+
+    public Map<String, Object> asMap() {
+        return new HashMap<>(capabilities);
+    }
+}`;
+
+export const newResultTemplate: string = `package org.openqa.selenium.bidirectional.session;
+
+import java.util.Map;
+
+/**
+ * Result for session.New command.
+ * Auto-generated from the CDDL specification.
+ */
+public class NewResult {
+    private final String sessionId;
+    private final Capabilities capabilities;
+
+    /**
+     * Constructor for NewResult.
+     *
+     * @param sessionId The session ID
+     * @param capabilities The capabilities map
+     */
+    public NewResult(String sessionId, Map<String, Object> capabilities) {
+        this.sessionId = sessionId;
+        this.capabilities = new Capabilities(capabilities);
+    }
+
+    /**
+     * Get the session ID.
+     *
+     * @return The session ID
+     */
+    public String getSessionId() {
+        return sessionId;
+    }
+
+    /**
+     * Get the capabilities.
+     *
+     * @return The capabilities
+     */
+    public Capabilities getCapabilities() {
+        return capabilities;
+    }
+}`;

package/src/utils.ts

@@ -0,0 +1,23 @@
+import fs from 'node:fs/promises'
+
+import { GENERATED_FILE_COMMENT } from './constants.js'
+import camelcase from 'camelcase'
+
+/**
+ * write generated ts file so it
+ *   - passes our eslint rules (no crlf)
+ *   - and has a note at the top that the file is generated
+ *
+ * @param filePath path to file to write
+ * @param content content of file
+ */
+export async function writeFile (filePath: string, content: string) {
+    return fs.writeFile(
+        filePath,
+        GENERATED_FILE_COMMENT + '\n\n' + content.replace(/\r\n/g, '\n')
+    )
+}
+
+export function pascalCase(name: string) {
+    return camelcase(name, { pascalCase: true })
+}

package/tests/__fixtures__/AccessibilityValue.java

@@ -0,0 +1,71 @@
+/**
+ * !!! PLEASE DO NOT EDIT THIS FILE !!!
+ *
+ * This source file, even though checked in, is auto-generated based on the
+ * current development within the WebDriver Bidi spec. Any changes to this
+ * file need to come from the specification.
+ */
+
+package org.openqa.selenium.bidirectional;
+
+import java.util.Map;
+import java.util.HashMap;
+
+/**
+ * Represents a value with accessibility properties in WebDriver BiDi protocol
+ */
+public class AccessibilityValue {
+    private final String name;
+    private final String role;
+    private final Map<String, Object> additionalProperties = new HashMap<>();
+
+    /**
+     * Creates a new AccessibilityValue instance
+     * @param name The accessible name
+     * @param role The accessible role
+     */
+    public AccessibilityValue(String name, String role) {
+        this.name = name;
+        this.role = role;
+    }
+
+    /**
+     * Gets the name property
+     * @return Name value
+     */
+    public String getName() {
+        return name;
+    }
+
+    /**
+     * Gets the role property
+     * @return Role value
+     */
+    public String getRole() {
+        return role;
+    }
+
+    /**
+     * Adds an additional property to this value
+     * @param key Property name
+     * @param value Property value
+     */
+    public void addProperty(String key, Object value) {
+        additionalProperties.put(key, value);
+    }
+
+    /**
+     * Converts this object to a map for use with BiDi protocol
+     * @return Map representation of this object
+     */
+    public Map<String, Object> asMap() {
+        Map<String, Object> result = new HashMap<>(additionalProperties);
+        if (name != null) {
+            result.put("name", name);
+        }
+        if (role != null) {
+            result.put("role", role);
+        }
+        return result;
+    }
+}

package/tests/__fixtures__/Browser/BrowserModule.java

@@ -0,0 +1,34 @@
+/**
+ * !!! PLEASE DO NOT EDIT THIS FILE !!!
+ *
+ * This source file, even though checked in, is auto-generated based on the
+ * current development within the WebDriver Bidi spec. Any changes to this
+ * file need to come from the specification.
+ */
+
+package org.openqa.selenium.bidirectional.browser;
+
+import java.util.Map;
+import java.util.HashMap;
+import org.openqa.selenium.bidi.Command;
+import org.openqa.selenium.bidirectional.EmptyResult;
+
+/**
+ * Auto generated class for running WebDriver BiDi browser commands in Java
+ */
+public class BrowserModule {
+
+    /**
+     * WebDriver Bidi command to send command method "browser.setClientWindowState" with parameters.
+     * @url https://w3c.github.io/webdriver-bidi/#command-browser-setClientWindowState
+     * @param parameters `SetClientWindowStateParameters` {@link https://w3c.github.io/webdriver-bidi/#command-browser-setClientWindowState | command parameter}
+     * @return Command object with result type for browser.setClientWindowState
+     */
+    public Command<org.openqa.selenium.bidirectional.EmptyResult> SetClientWindowState (SetClientWindowStateParameters parameters) {
+        return new Command<>(
+            "browser.setClientWindowState",
+            parameters.asMap(),
+            org.openqa.selenium.bidirectional.EmptyResult.class
+        );
+    }
+}

package/tests/__fixtures__/Browser/ClientWindowInfo.java

@@ -0,0 +1,122 @@
+/**
+ * !!! PLEASE DO NOT EDIT THIS FILE !!!
+ *
+ * This source file, even though checked in, is auto-generated based on the
+ * current development within the WebDriver Bidi spec. Any changes to this
+ * file need to come from the specification.
+ */
+
+package org.openqa.selenium.bidirectional.browser;
+
+import java.util.Map;
+import java.util.HashMap;
+import java.util.List;
+import java.util.ArrayList;
+import org.openqa.selenium.bidirectional.*;
+
+/**
+ * Auto-generated class for WebDriver BiDi protocol
+ * Represents parameters for browser.ClientWindowInfo command
+ */
+public class ClientWindowInfo {
+
+    /**
+     * Creates a new ClientWindowInfo instance
+     */
+    public ClientWindowInfo(Boolean active, String clientWindow, Long height, Object state, Long width, Integer x, Integer y) {
+        this.active = active;
+        this.clientWindow = clientWindow;
+        this.height = height;
+        this.state = state;
+        this.width = width;
+        this.x = x;
+        this.y = y;
+    }
+
+    private final Boolean active;
+
+    /**
+     * Gets the active property
+     * @return Boolean value
+     */
+    public Boolean getActive() {
+        return this.active;
+    }
+
+    private final String clientWindow;
+
+    /**
+     * Gets the clientWindow property
+     * @return String value
+     */
+    public String getClientWindow() {
+        return this.clientWindow;
+    }
+
+    private final Long height;
+
+    /**
+     * Gets the height property
+     * @return Long value
+     */
+    public Long getHeight() {
+        return this.height;
+    }
+
+    private final Object state;
+
+    /**
+     * Gets the state property
+     * @return Object value
+     */
+    public Object getState() {
+        return this.state;
+    }
+
+    private final Long width;
+
+    /**
+     * Gets the width property
+     * @return Long value
+     */
+    public Long getWidth() {
+        return this.width;
+    }
+
+    private final Integer x;
+
+    /**
+     * Gets the x property
+     * @return Integer value
+     */
+    public Integer getX() {
+        return this.x;
+    }
+
+    private final Integer y;
+
+    /**
+     * Gets the y property
+     * @return Integer value
+     */
+    public Integer getY() {
+        return this.y;
+    }
+
+    /**
+     * Converts this object to a map for use with BiDi protocol
+     * @return Map representation of this object
+     */
+    public Map<String, Object> asMap() {
+        Map<String, Object> toReturn = new HashMap<>();
+        toReturn.put("active", this.active);
+        toReturn.put("clientWindow", this.clientWindow);
+        toReturn.put("height", this.height);
+        toReturn.put("state", this.state);
+        toReturn.put("width", this.width);
+        toReturn.put("x", this.x);
+        toReturn.put("y", this.y);
+        return toReturn;
+    }
+
+}

package/tests/__fixtures__/Browser/ClientWindowNamedState.java

@@ -0,0 +1,50 @@
+/**
+ * !!! PLEASE DO NOT EDIT THIS FILE !!!
+ *
+ * This source file, even though checked in, is auto-generated based on the
+ * current development within the WebDriver Bidi spec. Any changes to this
+ * file need to come from the specification.
+ */
+
+package org.openqa.selenium.bidirectional.browser;
+
+import java.util.Map;
+import java.util.HashMap;
+import java.util.List;
+import java.util.ArrayList;
+import org.openqa.selenium.bidirectional.*;
+
+/**
+ * Auto-generated class for WebDriver BiDi protocol
+ * Represents parameters for browser.ClientWindowNamedState command
+ */
+public class ClientWindowNamedState {
+
+    /**
+     * Creates a new ClientWindowNamedState instance
+     */
+    public ClientWindowNamedState(Object state) {
+        this.state = state;
+    }
+
+    private final Object state;
+
+    /**
+     * Gets the state property
+     * @return Object value
+     */
+    public Object getState() {
+        return this.state;
+    }
+
+    /**
+     * Converts this object to a map for use with BiDi protocol
+     * @return Map representation of this object
+     */
+    public Map<String, Object> asMap() {
+        Map<String, Object> toReturn = new HashMap<>();
+        toReturn.put("state", this.state);
+        return toReturn;
+    }
+
+}

package/tests/__fixtures__/Browser/ClientWindowRectState.java

@@ -0,0 +1,98 @@
+/**
+ * !!! PLEASE DO NOT EDIT THIS FILE !!!
+ *
+ * This source file, even though checked in, is auto-generated based on the
+ * current development within the WebDriver Bidi spec. Any changes to this
+ * file need to come from the specification.
+ */
+
+package org.openqa.selenium.bidirectional.browser;
+
+import java.util.Map;
+import java.util.HashMap;
+import java.util.List;
+import java.util.ArrayList;
+import org.openqa.selenium.bidirectional.*;
+
+/**
+ * Auto-generated class for WebDriver BiDi protocol
+ * Represents parameters for browser.ClientWindowRectState command
+ */
+public class ClientWindowRectState {
+
+    /**
+     * Creates a new ClientWindowRectState instance
+     */
+    public ClientWindowRectState(Long width, Long height, Integer x, Integer y) {
+        this.width = width;
+        this.height = height;
+        this.x = x;
+        this.y = y;
+        this.state = "normal";
+    }
+
+    private final String state;
+
+    /**
+     * Gets the state property
+     * @return String value
+     */
+    public String getState() {
+        return this.state;
+    }
+
+    private final Long width;
+
+    /**
+     * Gets the width property
+     * @return Long value
+     */
+    public Long getWidth() {
+        return this.width;
+    }
+
+    private final Long height;
+
+    /**
+     * Gets the height property
+     * @return Long value
+     */
+    public Long getHeight() {
+        return this.height;
+    }
+
+    private final Integer x;
+
+    /**
+     * Gets the x property
+     * @return Integer value
+     */
+    public Integer getX() {
+        return this.x;
+    }
+
+    private final Integer y;
+
+    /**
+     * Gets the y property
+     * @return Integer value
+     */
+    public Integer getY() {
+        return this.y;
+    }
+
+    /**
+     * Converts this object to a map for use with BiDi protocol
+     * @return Map representation of this object
+     */
+    public Map<String, Object> asMap() {
+        Map<String, Object> toReturn = new HashMap<>();
+        toReturn.put("state", this.state);
+        toReturn.put("width", this.width);
+        toReturn.put("height", this.height);
+        toReturn.put("x", this.x);
+        toReturn.put("y", this.y);
+        return toReturn;
+    }
+
+}

package/tests/__fixtures__/Browser/CreateUserContextResult.java

@@ -0,0 +1,16 @@
+/**
+ * !!! PLEASE DO NOT EDIT THIS FILE !!!
+ *
+ * This source file, even though checked in, is auto-generated based on the
+ * current development within the WebDriver Bidi spec. Any changes to this
+ * file need to come from the specification.
+ */
+
+/**
+ * Auto-generated class for WebDriver BiDi protocol
+ * Represents enum for browser.CreateUserContextResult which can be either of these classes:
+ *   - browser.UserContextInfo
+ */
+public class CreateUserContextResult {
+
+}