Implement namespace properties and type methods

Fixes #24

Author: cypressious

declarations/src/main/kotlin/browserSettings/browserSettings.kt

@@ -1,5 +1,7 @@
 package browserSettings
 
+import types.Setting
+
 /**
  * How images should be animated in the browser. */
 typealias ImageAnimationBehavior = String
@@ -8,4 +10,83 @@ typealias ImageAnimationBehavior = String
  * After which mouse event context menus should popup. */
 typealias ContextMenuMouseEvent = String
 
-external class BrowserSettingsNamespace
+external class BrowserSettingsNamespace {
+    /**
+     * Allows or disallows pop-up windows from opening in response to user events.
+     */
+    var allowPopupsForUserEvents: Setting
+
+    /**
+     * Enables or disables the browser cache.
+     */
+    var cacheEnabled: Setting
+
+    /**
+     * This boolean setting controls whether the selected tab can be closed with a double click.
+     */
+    var closeTabsByDoubleClick: Setting
+
+    /**
+     * Controls after which mouse event context menus popup. This setting's value is of type
+            ContextMenuMouseEvent, which has possible values of <code>mouseup</code> and
+            <code>mousedown</code>.
+     */
+    var contextMenuShowEvent: Setting
+
+    /**
+     * Returns the value of the overridden home page. Read-only.
+     */
+    var homepageOverride: Setting
+
+    /**
+     * Controls the behaviour of image animation in the browser. This setting's value is of type
+            ImageAnimationBehavior, defaulting to <code>normal</code>.
+     */
+    var imageAnimationBehavior: Setting
+
+    /**
+     * Returns the value of the overridden new tab page. Read-only.
+     */
+    var newTabPageOverride: Setting
+
+    /**
+     * Controls where new tabs are opened. `afterCurrent` will open all new tabs next to the current
+            tab, `relatedAfterCurrent` will open only related tabs next to the current tab, and
+            `atEnd` will open all tabs at the end of the tab strip. The default is
+            `relatedAfterCurrent`.
+     */
+    var newTabPosition: Setting
+
+    /**
+     * This boolean setting controls whether bookmarks are opened in the current tab or in a new
+            tab.
+     */
+    var openBookmarksInNewTabs: Setting
+
+    /**
+     * This boolean setting controls whether search results are opened in the current tab or in a
+            new tab.
+     */
+    var openSearchResultsInNewTabs: Setting
+
+    /**
+     * This boolean setting controls whether urlbar results are opened in the current tab or in a
+            new tab.
+     */
+    var openUrlbarResultsInNewTabs: Setting
+
+    /**
+     * Disables webAPI notifications.
+     */
+    var webNotificationsDisabled: Setting
+
+    /**
+     * This setting controls whether the user-chosen colors override the page's colors.
+     */
+    var overrideDocumentColors: Setting
+
+    /**
+     * This setting controls whether the document's fonts are used.
+     */
+    var useDocumentFonts: Setting
+}

declarations/src/main/kotlin/contentScripts/contentScripts.kt

@@ -31,8 +31,14 @@ class RegisteredContentScriptOptions(
 )
 
 /**
- * An object that represents a content script registered programmatically */
-typealias RegisteredContentScript = Any
+ * An object that represents a content script registered programmatically
+ */
+external class RegisteredContentScript {
+    /**
+     * Unregister a content script registered programmatically
+     */
+    fun unregister(): Promise<Any>
+}
 
 external class ContentScriptsNamespace {
     /**

declarations/src/main/kotlin/devtools/devtools.kt

@@ -4,13 +4,36 @@ import manifest.ExtensionURL
 import webextensions.Event
 import kotlin.js.Promise
 
+/**
+ * Set to undefined if the resource content was set successfully; describes error otherwise.
+ */
+@Suppress("NOTHING_TO_INLINE", "UnsafeCastFromDynamic")
+class Error() {
+    inline operator fun get(key: String): dynamic = asDynamic()[key]
+    inline operator fun set(key: String, value: dynamic) {
+        asDynamic()[key] = value
+    }
+}
+
 /**
  * A resource within the inspected page, such as a document, a script, or an image.
- * @param url The URL of the resource.
  */
-class Resource(
+external class Resource {
+    /**
+     * The URL of the resource.
+     */
     var url: String
-)
+
+    /**
+     * Gets the content of the resource.
+     */
+    fun getContent(): Promise<String>
+
+    /**
+     * Sets the content of the resource.
+     */
+    fun setContent(content: String, commit: Boolean): Promise<Error?>
+}
 
 /**
  * The options parameter can contain one or more options.
@@ -57,6 +80,11 @@ class ReloadOptions(
 )
 
 external class InspectedWindowNamespace {
+    /**
+     * The ID of the tab being inspected. This ID may be used with chrome.tabs.* API.
+     */
+    var tabId: Int
+
     /**
      * Evaluates a JavaScript expression in the context of the main frame of the inspected page. The
             expression must evaluate to a JSON-compliant object, otherwise an exception is thrown.
@@ -78,8 +106,14 @@ external class InspectedWindowNamespace {
 
 /**
  * Represents a network request for a document resource (script, image and so on). See HAR
-        Specification for reference. */
-typealias Request = Any
+        Specification for reference.
+ */
+external class Request {
+    /**
+     * Returns content of the response body.
+     */
+    fun getContent(): Promise<String>
+}
 
 /**
  * A HAR log. See HAR specification for details.
@@ -113,24 +147,79 @@ external class NetworkNamespace {
 }
 
 /**
- * Represents the Elements panel. */
-typealias ElementsPanel = Any
+ * Represents the Elements panel.
+ */
+external class ElementsPanel {
+    /**
+     * Creates a pane within panel's sidebar.
+     */
+    fun createSidebarPane(title: String): Promise<ExtensionSidebarPane>
+}
 
 /**
- * Represents the Sources panel. */
-typealias SourcesPanel = Any
+ * Represents the Sources panel.
+ */
+external class SourcesPanel {
+    /**
+     * Creates a pane within panel's sidebar.
+     */
+    fun createSidebarPane(title: String, callback: (() -> Unit)? = definedExternally)
+}
 
 /**
- * Represents a panel created by extension. */
-typealias ExtensionPanel = Any
+ * Represents a panel created by extension.
+ */
+external class ExtensionPanel {
+    /**
+     * Appends a button to the status bar of the panel.
+     */
+    fun createStatusBarButton(
+        iconPath: String,
+        tooltipText: String,
+        disabled: Boolean
+    ): Button
+}
 
 /**
- * A sidebar created by the extension. */
-typealias ExtensionSidebarPane = Any
+ * A sidebar created by the extension.
+ */
+external class ExtensionSidebarPane {
+    /**
+     * Sets the height of the sidebar.
+     */
+    fun setHeight(height: String)
+
+    /**
+     * Sets an expression that is evaluated within the inspected page. The result is displayed in
+            the sidebar pane.
+     */
+    fun setExpression(expression: String, rootTitle: String? = definedExternally): Promise<Any>
+
+    /**
+     * Sets a JSON-compliant object to be displayed in the sidebar pane.
+     */
+    fun setObject(jsonObject: String, rootTitle: String? = definedExternally): Promise<Any>
+
+    /**
+     * Sets an HTML page to be displayed in the sidebar pane.
+     */
+    fun setPage(path: ExtensionURL): Promise<Any>
+}
 
 /**
- * A button created by the extension. */
-typealias Button = Any
+ * A button created by the extension.
+ */
+external class Button {
+    /**
+     * Updates the attributes of the button. If some of the arguments are omitted or
+            <code>null</code>, the corresponding attributes are not updated.
+     */
+    fun update(
+        iconPath: String? = definedExternally,
+        tooltipText: String? = definedExternally,
+        disabled: Boolean? = definedExternally
+    )
+}
 
 /**
  * Path of the panel's icon relative to the extension directory, or an empty string to use the
@@ -144,6 +233,21 @@ external class PanelsNamespace {
      * @param themeName The name of the current devtools theme. */
     val onThemeChanged: Event<(themeName: String) -> Unit>
 
+    /**
+     * Elements panel.
+     */
+    var elements: ElementsPanel
+
+    /**
+     * Sources panel.
+     */
+    var sources: SourcesPanel
+
+    /**
+     * The name of the current devtools theme.
+     */
+    var themeName: String
+
 //    /**
 //     * Creates an extension panel.
 //     */

declarations/src/main/kotlin/events/events.kt

@@ -17,8 +17,53 @@ class Rule(
 )
 
 /**
- * An object which allows the addition and removal of listeners for a Chrome event. */
-typealias Event = Any
+ * An object which allows the addition and removal of listeners for a Chrome event.
+ */
+external class Event {
+    /**
+     * Registers an event listener <em>callback</em> to an event.
+     */
+    fun addListener(callback: () -> Unit)
+
+    /**
+     * Deregisters an event listener <em>callback</em> from an event.
+     */
+    fun removeListener(callback: () -> Unit)
+
+    fun hasListener(callback: () -> Unit): Boolean
+
+    fun hasListeners(): Boolean
+
+    /**
+     * Registers rules to handle events.
+     */
+    fun addRules(
+        eventName: String,
+        webViewInstanceId: Int,
+        rules: Array<Rule>,
+        callback: (() -> Unit)? = definedExternally
+    )
+
+    /**
+     * Returns currently registered rules.
+     */
+    fun getRules(
+        eventName: String,
+        webViewInstanceId: Int,
+        ruleIdentifiers: Array<String>? = definedExternally,
+        callback: () -> Unit
+    )
+
+    /**
+     * Unregisters currently registered rules.
+     */
+    fun removeRules(
+        eventName: String,
+        webViewInstanceId: Int,
+        ruleIdentifiers: Array<String>? = definedExternally,
+        callback: (() -> Unit)? = definedExternally
+    )
+}
 
 /**
  * Filters URLs for various criteria. See <a href='events#filtered'>event filtering</a>. All

declarations/src/main/kotlin/extension/extension.kt

@@ -51,6 +51,19 @@ class GetBackgroundPageResult() {
 }
 
 external class ExtensionNamespace {
+    /**
+     * Set for the lifetime of a callback if an ansychronous extension api has resulted in an error.
+            If no error has occured lastError will be <var>undefined</var>.
+     */
+    var lastError: LastError?
+
+    /**
+     * True for content scripts running inside incognito tabs, and for extension pages running
+            inside an incognito process. The latter only applies to extensions with 'split'
+            incognito_behavior.
+     */
+    var inIncognitoContext: Boolean?
+
     /**
      * Converts a relative path within an extension install directory to a fully-qualified URL.
      */

declarations/src/main/kotlin/manifest/manifest.kt

@@ -2,6 +2,7 @@ package manifest
 
 import experiments.ExperimentAPI
 import extensionTypes.RunAt
+import kotlin.Suppress
 
 typealias OptionalPermission = Any
 

declarations/src/main/kotlin/menus/menus.kt

@@ -247,6 +247,12 @@ external class MenusNamespace {
      */
     val onHidden: Event<() -> Unit>
 
+    /**
+     * The maximum number of top level extension items that can be added to an extension action
+            context menu. Any items beyond this limit will be ignored.
+     */
+    var ACTION_MENU_TOP_LEVEL_LIMIT: Double
+
     /**
      * Creates a new context menu item. Note that if an error occurs during creation, you may not
             find out until the creation callback fires (the details will be in

declarations/src/main/kotlin/permissions/permissions.kt

@@ -1,9 +1,9 @@
 package permissions
 
+import kotlin.js.Promise
 import manifest.MatchPattern
 import manifest.OptionalPermission
 import manifest.Permission
-import kotlin.js.Promise
 
 class Permissions(var permissions: Array<OptionalPermission>? = null, var origins:
         Array<MatchPattern>? = null)