regenerate declarations

Author: cypressious

declarations/src/main/kotlin/alarms/alarms.kt

@@ -6,7 +6,8 @@ import webextensions.Event
 /**
  * @param name Name of this alarm.
  * @param scheduledTime Time when the alarm is scheduled to fire, in milliseconds past the epoch.
- * @param periodInMinutes When present, signals that the alarm triggers periodically after so many minutes.
+ * @param periodInMinutes When present, signals that the alarm triggers periodically after so many
+        minutes.
  */
 class Alarm(
     var name: String,
@@ -15,9 +16,15 @@ class Alarm(
 )
 
 /**
- * Details about the alarm. The alarm first fires either at 'when' milliseconds past the epoch (if 'when' is provided), after 'delayInMinutes' minutes from the current time (if 'delayInMinutes' is provided instead), or after 'periodInMinutes' minutes from the current time (if only 'periodInMinutes' is provided). Users should never provide both 'when' and 'delayInMinutes'. If 'periodInMinutes' is provided, then the alarm recurs repeatedly after that many minutes.
+ * Details about the alarm. The alarm first fires either at 'when' milliseconds past the epoch (if
+        'when' is provided), after 'delayInMinutes' minutes from the current time (if
+        'delayInMinutes' is provided instead), or after 'periodInMinutes' minutes from the current
+        time (if only 'periodInMinutes' is provided). Users should never provide both 'when' and
+        'delayInMinutes'. If 'periodInMinutes' is provided, then the alarm recurs repeatedly after
+        that many minutes.
  * @param when Time when the alarm is scheduled to first fire, in milliseconds past the epoch.
- * @param delayInMinutes Number of minutes from the current time after which the alarm should first fire.
+ * @param delayInMinutes Number of minutes from the current time after which the alarm should first
+        fire.
  * @param periodInMinutes Number of minutes after which the alarm should recur repeatedly.
  */
 class AlarmInfo(
@@ -34,7 +41,9 @@ external class AlarmsNamespace {
     val onAlarm: Event<(name: Alarm) -> Unit>
 
     /**
-     * Creates an alarm. After the delay is expired, the onAlarm event is fired. If there is another alarm with the same name (or no name if none is specified), it will be cancelled and replaced by this alarm.
+     * Creates an alarm. After the delay is expired, the onAlarm event is fired. If there is another
+            alarm with the same name (or no name if none is specified), it will be cancelled and
+            replaced by this alarm.
      */
     fun create(name: String? = definedExternally, alarmInfo: AlarmInfo)
 

declarations/src/main/kotlin/bookmarks/bookmarks.kt

@@ -4,24 +4,34 @@ import kotlin.js.Promise
 import webextensions.Event
 
 /**
- * Indicates the reason why this node is unmodifiable. The <var>managed</var> value indicates that this node was configured by the system administrator or by the custodian of a supervised user. Omitted if the node can be modified by the user and the extension (default). */
+ * Indicates the reason why this node is unmodifiable. The <var>managed</var> value indicates that
+        this node was configured by the system administrator or by the custodian of a supervised
+        user. Omitted if the node can be modified by the user and the extension (default). */
 typealias BookmarkTreeNodeUnmodifiable = String
 
 /**
  * Indicates the type of a BookmarkTreeNode, which can be one of bookmark, folder or separator. */
 typealias BookmarkTreeNodeType = String
 
 /**
- * A node (either a bookmark or a folder) in the bookmark tree.  Child nodes are ordered within their parent folder.
- * @param id The unique identifier for the node. IDs are unique within the current profile, and they remain valid even after the browser is restarted.
+ * A node (either a bookmark or a folder) in the bookmark tree.  Child nodes are ordered within
+        their parent folder.
+ * @param id The unique identifier for the node. IDs are unique within the current profile, and they
+        remain valid even after the browser is restarted.
  * @param parentId The <code>id</code> of the parent folder.  Omitted for the root node.
  * @param index The 0-based position of this node within its parent folder.
  * @param url The URL navigated to when a user clicks the bookmark. Omitted for folders.
  * @param title The text displayed for the node.
- * @param dateAdded When this node was created, in milliseconds since the epoch (<code>new Date(dateAdded)</code>).
- * @param dateGroupModified When the contents of this folder last changed, in milliseconds since the epoch.
- * @param unmodifiable Indicates the reason why this node is unmodifiable. The <var>managed</var> value indicates that this node was configured by the system administrator or by the custodian of a supervised user. Omitted if the node can be modified by the user and the extension (default).
- * @param type Indicates the type of the BookmarkTreeNode, which can be one of bookmark, folder or separator.
+ * @param dateAdded When this node was created, in milliseconds since the epoch (<code>new
+        Date(dateAdded)</code>).
+ * @param dateGroupModified When the contents of this folder last changed, in milliseconds since the
+        epoch.
+ * @param unmodifiable Indicates the reason why this node is unmodifiable. The <var>managed</var>
+        value indicates that this node was configured by the system administrator or by the
+        custodian of a supervised user. Omitted if the node can be modified by the user and the
+        extension (default).
+ * @param type Indicates the type of the BookmarkTreeNode, which can be one of bookmark, folder or
+        separator.
  * @param children An ordered list of children of this node.
  */
 class BookmarkTreeNode(
@@ -40,7 +50,8 @@ class BookmarkTreeNode(
 /**
  * Object passed to the create() function.
  * @param parentId Defaults to the Other Bookmarks folder.
- * @param type Indicates the type of BookmarkTreeNode to create, which can be one of bookmark, folder or separator.
+ * @param type Indicates the type of BookmarkTreeNode to create, which can be one of bookmark,
+        folder or separator.
  */
 class CreateDetails(
     var parentId: String? = null,
@@ -55,8 +66,10 @@ class CreateDetails(
 typealias IdOrIdList = Any
 
 /**
- * An object specifying properties and values to match when searching. Produces bookmarks matching all properties.
- * @param query A string of words and quoted phrases that are matched against bookmark URLs and titles.
+ * An object specifying properties and values to match when searching. Produces bookmarks matching
+        all properties.
+ * @param query A string of words and quoted phrases that are matched against bookmark URLs and
+        titles.
  * @param url The URL of the bookmark; matches verbatim. Note that folders have no URL.
  * @param title The title of the bookmark; matches verbatim.
  */
@@ -67,7 +80,10 @@ class Query(
 )
 
 /**
- * Either a string of words and quoted phrases that are matched against bookmark URLs and titles, or an object. If an object, the properties <code>query</code>, <code>url</code>, and <code>title</code> may be specified and bookmarks matching all specified properties will be produced. */
+ * Either a string of words and quoted phrases that are matched against bookmark URLs and titles, or
+        an object. If an object, the properties <code>query</code>, <code>url</code>, and
+        <code>title</code> may be specified and bookmarks matching all specified properties will be
+        produced. */
 typealias Query2 = Any
 
 class Destination(var parentId: String? = null, var index: Int? = null)
@@ -100,14 +116,16 @@ external class BookmarksNamespace {
     val onCreated: Event<(id: String, bookmark: BookmarkTreeNode) -> Unit>
 
     /**
-     * Fired when a bookmark or folder is removed.  When a folder is removed recursively, a single notification is fired for the folder, and none for its contents.
+     * Fired when a bookmark or folder is removed.  When a folder is removed recursively, a single
+            notification is fired for the folder, and none for its contents.
      *
      * @param id null
      * @param removeInfo null */
     val onRemoved: Event<(id: String, removeInfo: RemoveInfo) -> Unit>
 
     /**
-     * Fired when a bookmark or folder changes.  <b>Note:</b> Currently, only title and url changes trigger this.
+     * Fired when a bookmark or folder changes.  <b>Note:</b> Currently, only title and url changes
+            trigger this.
      *
      * @param id null
      * @param changeInfo null */
@@ -151,17 +169,20 @@ external class BookmarksNamespace {
     fun getSubTree(id: String): Promise<Array<BookmarkTreeNode>>
 
     /**
-     * Searches for BookmarkTreeNodes matching the given query. Queries specified with an object produce BookmarkTreeNodes matching all specified properties.
+     * Searches for BookmarkTreeNodes matching the given query. Queries specified with an object
+            produce BookmarkTreeNodes matching all specified properties.
      */
     fun search(query: String): Promise<Array<BookmarkTreeNode>>
 
     /**
-     * Searches for BookmarkTreeNodes matching the given query. Queries specified with an object produce BookmarkTreeNodes matching all specified properties.
+     * Searches for BookmarkTreeNodes matching the given query. Queries specified with an object
+            produce BookmarkTreeNodes matching all specified properties.
      */
     fun search(query: Query): Promise<Array<BookmarkTreeNode>>
 
     /**
-     * Creates a bookmark or folder under the specified parentId.  If url is NULL or missing, it will be a folder.
+     * Creates a bookmark or folder under the specified parentId.  If url is NULL or missing, it
+            will be a folder.
      */
     fun create(bookmark: CreateDetails): Promise<BookmarkTreeNode>
 
@@ -171,7 +192,9 @@ external class BookmarksNamespace {
     fun move(id: String, destination: Destination): Promise<BookmarkTreeNode>
 
     /**
-     * Updates the properties of a bookmark or folder. Specify only the properties that you want to change; unspecified properties will be left unchanged.  <b>Note:</b> Currently, only 'title' and 'url' are supported.
+     * Updates the properties of a bookmark or folder. Specify only the properties that you want to
+            change; unspecified properties will be left unchanged.  <b>Note:</b> Currently, only
+            'title' and 'url' are supported.
      */
     fun update(id: String, changes: Changes): Promise<BookmarkTreeNode>
 

declarations/src/main/kotlin/browserAction/browserAction.kt

@@ -6,9 +6,14 @@ import tabs.Tab
 import webextensions.Event
 
 /**
- * Specifies to which tab or window the value should be set, or from which one it should be retrieved. If no tab nor window is specified, the global value is set or retrieved.
- * @param tabId When setting a value, it will be specific to the specified tab, and will automatically reset when the tab navigates. When getting, specifies the tab to get the value from; if there is no tab-specific value, the window one will be inherited.
- * @param windowId When setting a value, it will be specific to the specified window. When getting, specifies the window to get the value from; if there is no window-specific value, the global one will be inherited.
+ * Specifies to which tab or window the value should be set, or from which one it should be
+        retrieved. If no tab nor window is specified, the global value is set or retrieved.
+ * @param tabId When setting a value, it will be specific to the specified tab, and will
+        automatically reset when the tab navigates. When getting, specifies the tab to get the value
+        from; if there is no tab-specific value, the window one will be inherited.
+ * @param windowId When setting a value, it will be specific to the specified window. When getting,
+        specifies the window to get the value from; if there is no window-specific value, the global
+        one will be inherited.
  */
 class Details(
     var tabId: Int? = null,
@@ -18,7 +23,8 @@ class Details(
 typealias ColorArray = Array<Int>
 
 /**
- * Pixel data for an image. Must be an ImageData object (for example, from a <code>canvas</code> element).
+ * Pixel data for an image. Must be an ImageData object (for example, from a <code>canvas</code>
+        element).
  */
 @Suppress("NOTHING_TO_INLINE", "UnsafeCastFromDynamic")
 class ImageDataType() {
@@ -29,7 +35,9 @@ class ImageDataType() {
 }
 
 /**
- * An array of four integers in the range [0,255] that make up the RGBA color of the badge. For example, opaque red is <code>[255, 0, 0, 255]</code>. Can also be a string with a CSS value, with opaque red being <code>#FF0000</code> or <code>#F00</code>. */
+ * An array of four integers in the range [0,255] that make up the RGBA color of the badge. For
+        example, opaque red is <code>[255, 0, 0, 255]</code>. Can also be a string with a CSS value,
+        with opaque red being <code>#FF0000</code> or <code>#F00</code>. */
 typealias ColorValue = Any
 
 /**
@@ -52,7 +60,12 @@ class ImageData() {
 }
 
 /**
- * Either an ImageData object or a dictionary {size -> ImageData} representing icon to be set. If the icon is specified as a dictionary, the actual image to be used is chosen depending on screen's pixel density. If the number of image pixels that fit into one screen space unit equals <code>scale</code>, then image with size <code>scale</code> * 19 will be selected. Initially only scales 1 and 2 will be supported. At least one image must be specified. Note that 'details.imageData = foo' is equivalent to 'details.imageData = {'19': foo}' */
+ * Either an ImageData object or a dictionary {size -> ImageData} representing icon to be set. If
+        the icon is specified as a dictionary, the actual image to be used is chosen depending on
+        screen's pixel density. If the number of image pixels that fit into one screen space unit
+        equals <code>scale</code>, then image with size <code>scale</code> * 19 will be selected.
+        Initially only scales 1 and 2 will be supported. At least one image must be specified. Note
+        that 'details.imageData = foo' is equivalent to 'details.imageData = {'19': foo}' */
 typealias ImageData2 = Any
 
 @Suppress("NOTHING_TO_INLINE", "UnsafeCastFromDynamic")
@@ -64,12 +77,30 @@ class Path() {
 }
 
 /**
- * Either a relative image path or a dictionary {size -> relative image path} pointing to icon to be set. If the icon is specified as a dictionary, the actual image to be used is chosen depending on screen's pixel density. If the number of image pixels that fit into one screen space unit equals <code>scale</code>, then image with size <code>scale</code> * 19 will be selected. Initially only scales 1 and 2 will be supported. At least one image must be specified. Note that 'details.path = foo' is equivalent to 'details.imageData = {'19': foo}' */
+ * Either a relative image path or a dictionary {size -> relative image path} pointing to icon to be
+        set. If the icon is specified as a dictionary, the actual image to be used is chosen
+        depending on screen's pixel density. If the number of image pixels that fit into one screen
+        space unit equals <code>scale</code>, then image with size <code>scale</code> * 19 will be
+        selected. Initially only scales 1 and 2 will be supported. At least one image must be
+        specified. Note that 'details.path = foo' is equivalent to 'details.imageData = {'19': foo}'
+        */
 typealias Path2 = Any
 
 /**
- * @param imageData Either an ImageData object or a dictionary {size -> ImageData} representing icon to be set. If the icon is specified as a dictionary, the actual image to be used is chosen depending on screen's pixel density. If the number of image pixels that fit into one screen space unit equals <code>scale</code>, then image with size <code>scale</code> * 19 will be selected. Initially only scales 1 and 2 will be supported. At least one image must be specified. Note that 'details.imageData = foo' is equivalent to 'details.imageData = {'19': foo}'
- * @param path Either a relative image path or a dictionary {size -> relative image path} pointing to icon to be set. If the icon is specified as a dictionary, the actual image to be used is chosen depending on screen's pixel density. If the number of image pixels that fit into one screen space unit equals <code>scale</code>, then image with size <code>scale</code> * 19 will be selected. Initially only scales 1 and 2 will be supported. At least one image must be specified. Note that 'details.path = foo' is equivalent to 'details.imageData = {'19': foo}'
+ * @param imageData Either an ImageData object or a dictionary {size -> ImageData} representing icon
+        to be set. If the icon is specified as a dictionary, the actual image to be used is chosen
+        depending on screen's pixel density. If the number of image pixels that fit into one screen
+        space unit equals <code>scale</code>, then image with size <code>scale</code> * 19 will be
+        selected. Initially only scales 1 and 2 will be supported. At least one image must be
+        specified. Note that 'details.imageData = foo' is equivalent to 'details.imageData = {'19':
+        foo}'
+ * @param path Either a relative image path or a dictionary {size -> relative image path} pointing
+        to icon to be set. If the icon is specified as a dictionary, the actual image to be used is
+        chosen depending on screen's pixel density. If the number of image pixels that fit into one
+        screen space unit equals <code>scale</code>, then image with size <code>scale</code> * 19
+        will be selected. Initially only scales 1 and 2 will be supported. At least one image must
+        be specified. Note that 'details.path = foo' is equivalent to 'details.imageData = {'19':
+        foo}'
  */
 class Details3(
     var imageData: ImageData2? = null,
@@ -81,7 +112,8 @@ class Details3(
 typealias Popup = Any
 
 /**
- * @param popup The html file to show in a popup.  If set to the empty string (''), no popup is shown.
+ * @param popup The html file to show in a popup.  If set to the empty string (''), no popup is
+        shown.
  */
 class Details4(
     var popup: Popup
@@ -104,7 +136,8 @@ class Details7(var color: ColorValue)
 
 external class BrowserActionNamespace {
     /**
-     * Fired when a browser action icon is clicked.  This event will not fire if the browser action has a popup.
+     * Fired when a browser action icon is clicked.  This event will not fire if the browser action
+            has a popup.
      *
      * @param tab null */
     val onClicked: Event<(tab: Tab) -> Unit>
@@ -120,12 +153,15 @@ external class BrowserActionNamespace {
     fun getTitle(details: Details): Promise<String>
 
     /**
-     * Sets the icon for the browser action. The icon can be specified either as the path to an image file or as the pixel data from a canvas element, or as dictionary of either one of those. Either the <b>path</b> or the <b>imageData</b> property must be specified.
+     * Sets the icon for the browser action. The icon can be specified either as the path to an
+            image file or as the pixel data from a canvas element, or as dictionary of either one of
+            those. Either the <b>path</b> or the <b>imageData</b> property must be specified.
      */
     fun setIcon(details: Details3): Promise<Any>
 
     /**
-     * Sets the html document to be opened as a popup when the user clicks on the browser action's icon.
+     * Sets the html document to be opened as a popup when the user clicks on the browser action's
+            icon.
      */
     fun setPopup(details: Details4): Promise<Any>
 
@@ -140,7 +176,8 @@ external class BrowserActionNamespace {
     fun setBadgeText(details: Details5): Promise<Any>
 
     /**
-     * Gets the badge text of the browser action. If no tab nor window is specified is specified, the global badge text is returned.
+     * Gets the badge text of the browser action. If no tab nor window is specified is specified,
+            the global badge text is returned.
      */
     fun getBadgeText(details: Details): Promise<String>