pseudo-dom 0.17.0 → 1.0.0

package/dist/services/ElementService.js

@@ -57,27 +57,14 @@ const zeroRect = () => ({
 })
 /**
  * Simulate the behaviour of the Element Class when there is no DOM available.
- * @author Joshua Heagle <joshuaheagle@gmail.com>
- * @class
- * @augments PseudoNode
- * @property {string} tagName
- * @property {string} className
- * @property {string} id
- * @property {string} innerHtml
- * @property {Array} attributes
- * @property {function} hasAttribute
- * @property {function} setAttribute
- * @property {function} getAttribute
- * @property {function} removeAttribute
  */
 class ElementService extends NodeService_1.NodeService {
   /**
-   * @param {Object} [settings={}]
-   * @param {string} [settings.tagName=''] The name of the tag this element represents
-   * @param {Array<{name: string, value: *}>} [settings.attributes=[]] The attributes (also assigned as properties) to start with
-   * @param {PseudoNode|null} [settings.parent=null] The node to add this element to as its last child
-   * @param {Array<PseudoNode>} [settings.children=[]] The nodes to start as children
-   * @constructor
+   * @param settings
+   * @param settings.tagName The name of the tag this element represents
+   * @param settings.attributes The attributes (also assigned as properties) to start with
+   * @param settings.parent The node to add this element to as its last child
+   * @param settings.children The nodes to start as children
    */
   constructor ({
     tagName = '',
@@ -156,7 +143,6 @@ class ElementService extends NodeService_1.NodeService {
   /**
    * The attributes with the values they have now: the ones which are also properties (className, id, style, ...) can
    * have been changed through the property, which does not change the stored list.
-   * @returns {Array<{name: string, value: *}>}
    */
   currentAttributes () {
     return this.attributeList.map(({
@@ -175,7 +161,6 @@ class ElementService extends NodeService_1.NodeService {
   /**
    * A copy of this element without its children: the same tag and attributes (the values which are objects, such as
    * style, are copied too rather than shared), but not its parent or listeners.
-   * @returns {ElementService}
    */
   cloneShallow () {
     const copy = new this.constructor({
@@ -202,8 +187,7 @@ class ElementService extends NodeService_1.NodeService {
   /**
    * Elements are equal when they have the same tag and the same attributes (in any order), which is what isEqualNode
    * checks before it compares the children.
-   * @param {NodeService} other The element to compare with
-   * @returns {boolean}
+   * @param other The element to compare with
    */
   equalsShallow (other) {
     const mine = this.currentAttributes()
@@ -224,7 +208,6 @@ class ElementService extends NodeService_1.NodeService {
   /**
    * The local part of the element's qualified name. There is no real namespace parsing here, so this is always the
    * same as tagName.
-   * @returns {string}
    */
   get localName () {
     return this.tag
@@ -233,7 +216,6 @@ class ElementService extends NodeService_1.NodeService {
   /**
    * The element's namespace prefix, or null when it has none. There is no real namespace parsing here, so this is
    * always null.
-   * @returns {string|null}
    */
   get prefix () {
     return null
@@ -242,7 +224,6 @@ class ElementService extends NodeService_1.NodeService {
   /**
    * The HTML markup of this element's children. Only the getter is here (the setter, which needs to build new
    * elements from parsed HTML, is on HTMLElementService - see its class comment).
-   * @returns {string}
    */
   get innerHTML () {
     return (0, serializeHTML_1.serializeChildren)(this)
@@ -250,7 +231,6 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * The HTML markup of this element itself, including its children. Only the getter is here (see innerHTML).
-   * @returns {string}
    */
   get outerHTML () {
     return (0, serializeHTML_1.serializeOuter)(this)
@@ -281,11 +261,9 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * Some elements have default behaviour, this registers it when the element is added.
-   * @returns {Function}
    */
   /**
    * A live view of this element's element children (text, comments and the like are not included).
-   * @returns {PseudoHTMLCollection}
    */
   get children () {
     return new HTMLCollectionService_1.HTMLCollectionService(this)
@@ -293,7 +271,6 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * How many element children this element has.
-   * @returns {number}
    */
   get childElementCount () {
     return this.children.length
@@ -301,7 +278,6 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * The first child of this element which is an element, or null when there is none.
-   * @returns {PseudoElement|null}
    */
   get firstElementChild () {
     return this.children.item(0)
@@ -309,7 +285,6 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * The last child of this element which is an element, or null when there is none.
-   * @returns {PseudoElement|null}
    */
   get lastElementChild () {
     const elementChildren = this.children
@@ -318,7 +293,6 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * The sibling after this one which is an element, or null when there is none.
-   * @returns {PseudoElement|null}
    */
   get nextElementSibling () {
     let sibling = this.nextSibling
@@ -330,7 +304,6 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * The sibling before this one which is an element, or null when there is none.
-   * @returns {PseudoElement|null}
    */
   get previousElementSibling () {
     let sibling = this.previousSibling
@@ -344,9 +317,9 @@ class ElementService extends NodeService_1.NodeService {
    * Put an element at a position relative to this one: beforebegin (before this element, as its previous sibling),
    * afterbegin (as this element's first child), beforeend (as this element's last child) or afterend (after this
    * element, as its next sibling).
-   * @param {string} position beforebegin, afterbegin, beforeend or afterend
-   * @param {ElementService} element The element to insert
-   * @returns {ElementService|null} The inserted element, or null when the position needed a parent this element does not have
+   * @param position beforebegin, afterbegin, beforeend or afterend
+   * @param element The element to insert
+   * @returns The inserted element, or null when the position needed a parent this element does not have
    * @throws {Error} When the position is not one of the four above
    */
   insertAdjacentElement (position, element) {
@@ -355,8 +328,8 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * Put text at a position relative to this element, the same as insertAdjacentElement but the text becomes a text node.
-   * @param {string} position beforebegin, afterbegin, beforeend or afterend
-   * @param {string} text The text to insert
+   * @param position beforebegin, afterbegin, beforeend or afterend
+   * @param text The text to insert
    * @throws {Error} When the position is not one of the four above
    */
   insertAdjacentText (position, text) {
@@ -365,9 +338,9 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * Shared implementation for insertAdjacentElement / insertAdjacentText.
-   * @param {string} position beforebegin, afterbegin, beforeend or afterend
-   * @param {PseudoNode|string} node The node (or text) to insert
-   * @returns {PseudoNode|null} The inserted node, or null when the position needed a parent this element does not have
+   * @param position beforebegin, afterbegin, beforeend or afterend
+   * @param node The node (or text) to insert
+   * @returns The inserted node, or null when the position needed a parent this element does not have
    * @throws {Error} When the position is not one of the four above
    */
   insertAdjacent (position, node) {
@@ -397,8 +370,8 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * Not implemented yet (HTML parsing is out of scope for now).
-   * @param {string} position beforebegin, afterbegin, beforeend or afterend
-   * @param {string} text The markup which would be parsed
+   * @param position beforebegin, afterbegin, beforeend or afterend
+   * @param text The markup which would be parsed
    * @throws {Error}
    */
   insertAdjacentHTML (position, text) {
@@ -407,8 +380,7 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * Whether this element itself (not its descendants) matches the given CSS selector.
-   * @param {string} selectors A CSS selector
-   * @returns {boolean}
+   * @param selectors A CSS selector
    */
   matches (selectors) {
     return (0, query_1.matches)(this, selectors)
@@ -417,8 +389,7 @@ class ElementService extends NodeService_1.NodeService {
   /**
    * The nearest ancestor of this element (starting with this element itself) which matches the CSS selector, or
    * null when none of them do.
-   * @param {string} selectors A CSS selector
-   * @returns {PseudoElement|null}
+   * @param selectors A CSS selector
    */
   closest (selectors) {
     return (0, query_1.closest)(this, selectors)
@@ -452,7 +423,7 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * An element which is added as a child gets its default events (for example a submit button submits its form).
-   * @param {NodeService} child The node which was inserted
+   * @param child The node which was inserted
    */
   childInserted (child) {
     if (typeof child.applyDefaultEvent === 'function') {
@@ -462,8 +433,7 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * Check whether the element has an attribute by that name.
-   * @param {string} attributeName
-   * @returns {boolean}
+   * @param attributeName
    */
   hasAttribute (attributeName) {
     return this.attributeList.some(({
@@ -473,9 +443,8 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * Set the value of an attribute, adding the attribute if it did not exist.
-   * @param {string} attributeName
-   * @param {string} attributeValue
-   * @returns {undefined}
+   * @param attributeName
+   * @param attributeValue
    */
   setAttribute (attributeName, attributeValue) {
     const existing = this.attributeList.find(({
@@ -496,8 +465,8 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * Retrieve the value of an attribute.
-   * @param {string} attributeName
-   * @returns {string|null} The value, or null when there is no such attribute
+   * @param attributeName
+   * @returns The value, or null when there is no such attribute
    */
   getAttribute (attributeName) {
     const found = this.currentAttributes().find(({
@@ -508,8 +477,7 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * Remove an attribute from the element.
-   * @param {string} attributeName
-   * @returns {undefined}
+   * @param attributeName
    */
   removeAttribute (attributeName) {
     const index = this.attributeList.findIndex(({
@@ -522,7 +490,6 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * The name of every attribute on the element, in the order they were set.
-   * @returns {Array<string>}
    */
   getAttributeNames () {
     return this.currentAttributes().map(({
@@ -532,7 +499,6 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * Whether the element has any attributes at all.
-   * @returns {boolean}
    */
   hasAttributes () {
     return this.attributeList.length > 0
@@ -540,8 +506,8 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * Retrieve the node representation of an attribute.
-   * @param {string} attributeName
-   * @returns {AttrService|null} An Attr for the attribute, or null when there is no such attribute
+   * @param attributeName
+   * @returns An Attr for the attribute, or null when there is no such attribute
    */
   getAttributeNode (attributeName) {
     return this.hasAttribute(attributeName) ? new AttrService_1.AttrService(attributeName, this.getAttribute(attributeName) || '', this) : null
@@ -550,9 +516,9 @@ class ElementService extends NodeService_1.NodeService {
   /**
    * Retrieve the node representation of an attribute. There is no real namespace parsing here, so this ignores
    * the namespace and behaves exactly like getAttributeNode.
-   * @param {string} namespace Ignored
-   * @param {string} attributeName
-   * @returns {AttrService|null} An Attr for the attribute, or null when there is no such attribute
+   * @param namespace Ignored
+   * @param attributeName
+   * @returns An Attr for the attribute, or null when there is no such attribute
    */
   getAttributeNodeNS (namespace, attributeName) {
     return this.getAttributeNode(attributeName)
@@ -561,9 +527,9 @@ class ElementService extends NodeService_1.NodeService {
   /**
    * Retrieve the value of an attribute. There is no real namespace parsing here, so this ignores the namespace
    * and behaves exactly like getAttribute.
-   * @param {string} namespace Ignored
-   * @param {string} attributeName
-   * @returns {string|null} The value, or null when there is no such attribute
+   * @param namespace Ignored
+   * @param attributeName
+   * @returns The value, or null when there is no such attribute
    */
   getAttributeNS (namespace, attributeName) {
     return this.getAttribute(attributeName)
@@ -572,9 +538,8 @@ class ElementService extends NodeService_1.NodeService {
   /**
    * Check whether the element has an attribute by that name. There is no real namespace parsing here, so this
    * ignores the namespace and behaves exactly like hasAttribute.
-   * @param {string} namespace Ignored
-   * @param {string} attributeName
-   * @returns {boolean}
+   * @param namespace Ignored
+   * @param attributeName
    */
   hasAttributeNS (namespace, attributeName) {
     return this.hasAttribute(attributeName)
@@ -582,8 +547,8 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * Remove the node representation of an attribute from the element, and return it.
-   * @param {AttrService} attr
-   * @returns {AttrService} The removed Attr
+   * @param attr
+   * @returns The removed Attr
    * @throws {Error} When the element has no attribute matching attr.name
    */
   removeAttributeNode (attr) {
@@ -598,9 +563,8 @@ class ElementService extends NodeService_1.NodeService {
   /**
    * Remove an attribute from the element. There is no real namespace parsing here, so this ignores the namespace
    * and behaves exactly like removeAttribute.
-   * @param {string} namespace Ignored
-   * @param {string} attributeName
-   * @returns {undefined}
+   * @param namespace Ignored
+   * @param attributeName
    */
   removeAttributeNS (namespace, attributeName) {
     this.removeAttribute(attributeName)
@@ -609,8 +573,8 @@ class ElementService extends NodeService_1.NodeService {
   /**
    * Set the node representation of an attribute, adding the attribute if it did not exist. Returns any previous
    * Attr that had the same name, or null when there was none.
-   * @param {AttrService} attr
-   * @returns {AttrService|null} The replaced Attr, or null when the attribute was new
+   * @param attr
+   * @returns The replaced Attr, or null when the attribute was new
    */
   setAttributeNode (attr) {
     const existing = this.getAttributeNode(attr.name)
@@ -621,8 +585,8 @@ class ElementService extends NodeService_1.NodeService {
   /**
    * Set the node representation of an attribute. There is no real namespace parsing here, so this behaves
    * exactly like setAttributeNode (Attr.name already carries any prefix).
-   * @param {AttrService} attr
-   * @returns {AttrService|null} The replaced Attr, or null when the attribute was new
+   * @param attr
+   * @returns The replaced Attr, or null when the attribute was new
    */
   setAttributeNodeNS (attr) {
     return this.setAttributeNode(attr)
@@ -631,10 +595,9 @@ class ElementService extends NodeService_1.NodeService {
   /**
    * Set the value of an attribute, adding the attribute if it did not exist. There is no real namespace parsing
    * here, so this ignores the namespace and behaves exactly like setAttribute.
-   * @param {string} namespace Ignored
-   * @param {string} attributeName
-   * @param {string} attributeValue
-   * @returns {undefined}
+   * @param namespace Ignored
+   * @param attributeName
+   * @param attributeValue
    */
   setAttributeNS (namespace, attributeName, attributeValue) {
     this.setAttribute(attributeName, attributeValue)
@@ -643,9 +606,8 @@ class ElementService extends NodeService_1.NodeService {
   /**
    * Add the attribute (with an empty value) when it is not present, or remove it when it is - unless force says
    * which of those to do instead. Returns whether the attribute is present after the call.
-   * @param {string} attributeName
-   * @param {boolean} [force]
-   * @returns {boolean}
+   * @param attributeName
+   * @param force
    */
   toggleAttribute (attributeName, force) {
     const present = this.hasAttribute(attributeName)
@@ -660,7 +622,6 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * The size of the element and its position, settable directly - there is no layout engine here to compute it.
-   * @returns {DOMRect}
    */
   getBoundingClientRect () {
     return this.boundingClientRect
@@ -669,7 +630,6 @@ class ElementService extends NodeService_1.NodeService {
   /**
    * The bounding rectangles for each line of text in the element, settable directly - there is no layout engine
    * here to compute it.
-   * @returns {Array<DOMRect>}
    */
   getClientRects () {
     return this.clientRects
@@ -677,7 +637,6 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * The Animation objects currently active on the element, settable directly - there is no animation engine here.
-   * @returns {Array<*>}
    */
   getAnimations () {
     return this.animations
@@ -685,7 +644,6 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * Whether the element is expected to be visible, settable directly - there is no rendering here to check it.
-   * @returns {boolean}
    */
   checkVisibility () {
     return this.isVisible
@@ -694,7 +652,6 @@ class ElementService extends NodeService_1.NodeService {
   /**
    * A read-only view of the element's own inline style declarations (there is no CSS cascade here, so this is not a
    * real computed style - just what the element's own style object holds).
-   * @returns {{get: function(string): (string|undefined)}}
    */
   computedStyleMap () {
     const style = this.style
@@ -708,8 +665,7 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * Whether this element currently has capture of the given pointer.
-   * @param {number} pointerId
-   * @returns {boolean}
+   * @param pointerId
    */
   hasPointerCapture (pointerId) {
     return this.capturedPointers.has(pointerId)
@@ -717,8 +673,7 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * Give this element capture of the given pointer.
-   * @param {number} pointerId
-   * @returns {undefined}
+   * @param pointerId
    */
   setPointerCapture (pointerId) {
     this.capturedPointers.add(pointerId)
@@ -726,8 +681,7 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * Release this element's capture of the given pointer, if it had it.
-   * @param {number} pointerId
-   * @returns {undefined}
+   * @param pointerId
    */
   releasePointerCapture (pointerId) {
     this.capturedPointers.delete(pointerId)
@@ -736,9 +690,8 @@ class ElementService extends NodeService_1.NodeService {
   /**
    * Scroll to the given position (or, given an options object, the position(s) it has). There is no real scrollable
    * viewport here: this just sets scrollLeft / scrollTop.
-   * @param {number|{left: number, top: number}} [x=0]
-   * @param {number} [y=0]
-   * @returns {undefined}
+   * @param x
+   * @param y
    */
   scroll (x = 0, y = 0) {
     if (typeof x === 'number') {
@@ -756,9 +709,8 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * Scroll to the given position. An alias for scroll.
-   * @param {number|{left: number, top: number}} [x=0]
-   * @param {number} [y=0]
-   * @returns {undefined}
+   * @param x
+   * @param y
    */
   scrollTo (x = 0, y = 0) {
     this.scroll(x, y)
@@ -766,9 +718,8 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * Scroll by the given amount, relative to the current position.
-   * @param {number|{left: number, top: number}} [x=0]
-   * @param {number} [y=0]
-   * @returns {undefined}
+   * @param x
+   * @param y
    */
   scrollBy (x = 0, y = 0) {
     if (typeof x === 'number') {
@@ -784,13 +735,11 @@ class ElementService extends NodeService_1.NodeService {
   /**
    * Scroll an ancestor until this element is in view. There is no real viewport here for that to mean anything, so
    * this does nothing (override it on an instance in a test which needs to observe the call).
-   * @returns {undefined}
    */
   scrollIntoView () {}
   /**
    * Asynchronously ask for the element to be shown fullscreen. There is no real fullscreen here, so this just
    * resolves, like a browser granting the request would.
-   * @returns {Promise<void>}
    */
   requestFullscreen () {
     return Promise.resolve()
@@ -799,7 +748,6 @@ class ElementService extends NodeService_1.NodeService {
   /**
    * Asynchronously ask for the pointer to be locked to this element. There is no real pointer lock here, so this
    * just resolves, like a browser granting the request would.
-   * @returns {Promise<void>}
    */
   requestPointerLock () {
     return Promise.resolve()
@@ -807,8 +755,7 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * Attach a shadow tree to this element and return its ShadowRoot. Throws when it already hosts one.
-   * @param {{mode: string}} options
-   * @returns {PseudoShadowRoot}
+   * @param options
    * @throws {Error}
    */
   attachShadow (options) {
@@ -825,7 +772,6 @@ class ElementService extends NodeService_1.NodeService {
   /**
    * This element's shadow root, when it has one attached in 'open' mode, or null (including when the mode is
    * 'closed' - it still exists, but is not reachable this way, like the DOM's).
-   * @returns {PseudoShadowRoot|null}
    */
   get shadowRoot () {
     return this.shadowRootInstance && this.shadowRootInstance.mode === 'open' ? this.shadowRootInstance : null
@@ -833,8 +779,7 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * Read one of the aria-* reflected properties (see the individual aria* getters/setters below).
-   * @param {string} attributeName A real aria-* attribute name (aria-label, ...)
-   * @returns {string}
+   * @param attributeName A real aria-* attribute name (aria-label, ...)
    */
   getAriaAttribute (attributeName) {
     return this.getAttribute(attributeName) || ''
@@ -842,9 +787,8 @@ class ElementService extends NodeService_1.NodeService {
 
   /**
    * Write one of the aria-* reflected properties.
-   * @param {string} attributeName A real aria-* attribute name (aria-label, ...)
-   * @param {string} value
-   * @returns {undefined}
+   * @param attributeName A real aria-* attribute name (aria-label, ...)
+   * @param value
    */
   setAriaAttribute (attributeName, value) {
     this.setAttribute(attributeName, value)

package/dist/services/EventService.d.ts

@@ -1,7 +1,5 @@
 /**
- * @file Substitute for the DOM Event Class.
- * @author Joshua Heagle <joshuaheagle@gmail.com>
- * @version 1.0.0
+ * Substitute for the DOM Event Class.
  */
 import { PseudoEventTarget } from '../interfaces/PseudoEventTarget';
 import { PseudoEvent } from '../interfaces/PseudoEvent';
@@ -28,32 +26,6 @@ export type EventInner = {
 };
 /**
  * Simulate the behaviour of the Event Class when there is no DOM available.
- * @author Joshua Heagle <joshuaheagle@gmail.com>
- * @class
- * @property {number} NONE
- * @property {number} CAPTURING_PHASE
- * @property {number} AT_TARGET
- * @property {number} BUBBLING_PHASE
- * @property {boolean} bubbles - A Boolean indicating whether the event bubbles up through the Dom or not.
- * @property {boolean} cancelable - A Boolean indicating whether the event is cancelable.
- * @property {boolean} composed - A Boolean value indicating whether the event can bubble across the boundary
- * between the shadow Dom and the regular Dom.
- * @property {function|PseudoEventTarget} currentTarget - A reference to the currently registered target for the event. This
- * is the object to which the event is currently slated to be sent; it's possible this has been changed along the way
- * through re-targeting.
- * @property {boolean} defaultPrevented - Indicates whether event.preventDefault() has been called on the event.
- * @property {boolean} immediatePropagationStopped - Flag that no further propagation should occur, including on current
- * target.
- * @property {boolean} propagationStopped - Flag that no further propagation should occur.
- * @property {int} eventPhase - Indicates which phase of the event flow is being processed. Uses EventService constants.
- * @property {EventTarget|PseudoEventTarget} target - A reference to the target to which the event was originally
- * dispatched.
- * @property {int} timeStamp - The time at which the event was created (in milliseconds). By specification, this
- * value is time since epoch, but in reality browsers' definitions vary; in addition, work is underway to change this
- * to be a DomHighResTimeStamp instead.
- * @property {string} type - The name of the event (case-insensitive).
- * @property {boolean} isTrusted - Indicates whether the event was initiated by the browser (after a user
- * click for instance) or by a script (using an event creation method, like event.initEvent)
  */
 export declare class EventService implements PseudoEvent {
     static readonly NONE = 0;
@@ -63,12 +35,11 @@ export declare class EventService implements PseudoEvent {
     private properties;
     /**
      *
-     * @param {string} typeArg
-     * @param {Object} [eventOptions={}]
-     * @param {boolean} [eventOptions.bubbles=false]
-     * @param {boolean} [eventOptions.cancelable=false]
-     * @param {boolean} [eventOptions.composed=false]
-     * @constructor
+     * @param typeArg
+     * @param eventOptions
+     * @param eventOptions.bubbles
+     * @param eventOptions.cancelable
+     * @param eventOptions.composed
      */
     constructor(typeArg?: string, { bubbles, cancelable, composed }?: {
         bubbles?: boolean;
@@ -87,33 +58,24 @@ export declare class EventService implements PseudoEvent {
     get type(): string;
     /**
      * Scope several accessors inside the inner object. These are only intended for usage by other DOM classes.
-     * @returns {EventInner}
      */
     get inner(): EventInner;
     /**
      * Return an array of targets that will have the event executed open them. The order is based on the eventPhase
-     * @method
-     * @returns {Array.<PseudoEventTarget>}
      */
     composedPath(): Array<PseudoEventTarget>;
     /**
      * Cancels the event (if it is cancelable).
-     * @method
-     * @returns {null}
      */
     preventDefault(): null;
     /**
      * For this particular event, no other listener will be called.
      * Neither those attached on the same element, nor those attached on elements which will be traversed later (in
      * capture phase, for instance)
-     * @method
-     * @returns {null}
      */
     stopImmediatePropagation(): null;
     /**
      * Stops the propagation of events further along in the Dom.
-     * @method
-     * @returns {null}
      */
     stopPropagation(): null;
     private setReadOnlyProperties;