pseudo-dom 0.9.0 → 0.11.0

package/dist/interfaces/PseudoHTMLElement.d.ts

@@ -1,33 +1,33 @@
-/**
- * @file Substitute for the DOM HTMLElement Class.
- * @author Joshua Heagle <joshuaheagle@gmail.com>
- * @version 1.0.0
- */
-import { PseudoElement } from './PseudoElement';
-import { PseudoCSSStyleDeclaration } from './PseudoCSSStyleDeclaration';
-/**
- * Simulate the behaviour of the HTMLElement Class when there is no DOM available.
- * @author Joshua Heagle <joshuaheagle@gmail.com>
- * @class
- * @augments PseudoElement
- * @property {boolean} hidden - State of whether element is visible
- * @property {number} offsetHeight - The height of the element as offset by the parent element
- * @property {number} offsetLeft - The position of the left side of the element based on the parent element
- * @property {PseudoHTMLElement} offsetParent - A reference to the closest positioned parent element
- * @property {number} offsetTop - The position of the top side of the element based on the parent element
- * @property {number} offsetWidth - The width of the element as offset by the parent element
- * @property {string} title - The title attribute which affects the text visible on hover
- */
-export interface PseudoHTMLElement extends PseudoElement {
-    /**
-     * The element's inline styles, live and settable per property (style.color = 'red') as well as through the real
-     * CSSStyleDeclaration methods (getPropertyValue, setProperty, removeProperty, cssText).
-     */
-    get style(): PseudoCSSStyleDeclaration;
-    /**
-     * The element's data-* attributes, live, under their camelCase names (data-foo-bar <-> dataset.fooBar).
-     */
-    get dataset(): {
-        [key: string]: string;
-    };
-}
+/**
+ * @file Substitute for the DOM HTMLElement Class.
+ * @author Joshua Heagle <joshuaheagle@gmail.com>
+ * @version 1.0.0
+ */
+import { PseudoElement } from './PseudoElement';
+import { PseudoCSSStyleDeclaration } from './PseudoCSSStyleDeclaration';
+/**
+ * Simulate the behaviour of the HTMLElement Class when there is no DOM available.
+ * @author Joshua Heagle <joshuaheagle@gmail.com>
+ * @class
+ * @augments PseudoElement
+ * @property {boolean} hidden - State of whether element is visible
+ * @property {number} offsetHeight - The height of the element as offset by the parent element
+ * @property {number} offsetLeft - The position of the left side of the element based on the parent element
+ * @property {PseudoHTMLElement} offsetParent - A reference to the closest positioned parent element
+ * @property {number} offsetTop - The position of the top side of the element based on the parent element
+ * @property {number} offsetWidth - The width of the element as offset by the parent element
+ * @property {string} title - The title attribute which affects the text visible on hover
+ */
+export interface PseudoHTMLElement extends PseudoElement {
+    /**
+     * The element's inline styles, live and settable per property (style.color = 'red') as well as through the real
+     * CSSStyleDeclaration methods (getPropertyValue, setProperty, removeProperty, cssText).
+     */
+    get style(): PseudoCSSStyleDeclaration;
+    /**
+     * The element's data-* attributes, live, under their camelCase names (data-foo-bar <-> dataset.fooBar).
+     */
+    get dataset(): {
+        [key: string]: string;
+    };
+}

package/dist/interfaces/PseudoShadowRoot.d.ts

@@ -1,3 +1,12 @@
 import { PseudoDocumentFragment } from './PseudoDocumentFragment';
+import { PseudoElement } from './PseudoElement';
 export interface PseudoShadowRoot extends PseudoDocumentFragment {
+    /**
+     * The element this shadow root is attached to.
+     */
+    get host(): PseudoElement;
+    /**
+     * 'open' (reachable via element.shadowRoot) or 'closed' (not).
+     */
+    get mode(): string;
 }

package/dist/services/CSSStyleDeclarationService.d.ts

@@ -1,73 +1,73 @@
-/**
- * @file Substitute for the DOM CSSStyleDeclaration Class (the object behind Element.style).
- * @author Joshua Heagle <joshuaheagle@gmail.com>
- * @version 1.0.0
- */
-/**
- * Simulate the behaviour of the CSSStyleDeclaration Class when there is no DOM available: an ordered map of CSS
- * property/value pairs, parsed from and serialized back to a cssText string. Values are stored and returned as
- * given, with no unit conversion, shorthand expansion or validation - this is a data structure, not a real CSS
- * engine. Named property access (declaration.backgroundColor, camelCase) is added on top of this by
- * createStyleDeclaration, which wraps an instance of this class in a Proxy.
- * @author Joshua Heagle <joshuaheagle@gmail.com>
- * @class
- */
-export declare class CSSStyleDeclarationService {
-    private readonly properties;
-    /**
-     * @param {string} [cssText=''] Initial declarations, as CSS text ("color: red; font-size: 12px;")
-     * @constructor
-     */
-    constructor(cssText?: string);
-    /**
-     * How many properties are currently set.
-     * @returns {number}
-     */
-    get length(): number;
-    /**
-     * The name of the property at the given index, in the order it was set, or '' when there is none (matches the
-     * DOM's CSSStyleDeclaration, which is array-like).
-     * @param {number} index
-     * @returns {string}
-     */
-    item(index: number): string;
-    /**
-     * The value of the given property, or '' when it is not set.
-     * @param {string} property A CSS property name (kebab-case, e.g. "background-color")
-     * @returns {string}
-     */
-    getPropertyValue(property: string): string;
-    /**
-     * "important" when the property was set with !important, otherwise ''.
-     * @param {string} property A CSS property name (kebab-case)
-     * @returns {string}
-     */
-    getPropertyPriority(property: string): string;
-    /**
-     * Set a property's value (and optionally its priority). An empty, null or undefined value removes the property
-     * instead, like the DOM.
-     * @param {string} property A CSS property name (kebab-case)
-     * @param {string} value The value, or '' to remove the property
-     * @param {string} [priority=''] "important" to mark it !important
-     * @returns {undefined}
-     */
-    setProperty(property: string, value: string, priority?: string): void;
-    /**
-     * Remove a property, returning the value it had (or '' when it was not set).
-     * @param {string} property A CSS property name (kebab-case)
-     * @returns {string}
-     */
-    removeProperty(property: string): string;
-    /**
-     * All the declarations as one CSS text string.
-     * @returns {string}
-     */
-    get cssText(): string;
-    /**
-     * Replace every declaration by parsing a CSS text string ("color: red; font-size: 12px !important;").
-     * @param {string} cssText
-     * @returns {undefined}
-     */
-    set cssText(cssText: string);
-}
-export default CSSStyleDeclarationService;
+/**
+ * @file Substitute for the DOM CSSStyleDeclaration Class (the object behind Element.style).
+ * @author Joshua Heagle <joshuaheagle@gmail.com>
+ * @version 1.0.0
+ */
+/**
+ * Simulate the behaviour of the CSSStyleDeclaration Class when there is no DOM available: an ordered map of CSS
+ * property/value pairs, parsed from and serialized back to a cssText string. Values are stored and returned as
+ * given, with no unit conversion, shorthand expansion or validation - this is a data structure, not a real CSS
+ * engine. Named property access (declaration.backgroundColor, camelCase) is added on top of this by
+ * createStyleDeclaration, which wraps an instance of this class in a Proxy.
+ * @author Joshua Heagle <joshuaheagle@gmail.com>
+ * @class
+ */
+export declare class CSSStyleDeclarationService {
+    private readonly properties;
+    /**
+     * @param {string} [cssText=''] Initial declarations, as CSS text ("color: red; font-size: 12px;")
+     * @constructor
+     */
+    constructor(cssText?: string);
+    /**
+     * How many properties are currently set.
+     * @returns {number}
+     */
+    get length(): number;
+    /**
+     * The name of the property at the given index, in the order it was set, or '' when there is none (matches the
+     * DOM's CSSStyleDeclaration, which is array-like).
+     * @param {number} index
+     * @returns {string}
+     */
+    item(index: number): string;
+    /**
+     * The value of the given property, or '' when it is not set.
+     * @param {string} property A CSS property name (kebab-case, e.g. "background-color")
+     * @returns {string}
+     */
+    getPropertyValue(property: string): string;
+    /**
+     * "important" when the property was set with !important, otherwise ''.
+     * @param {string} property A CSS property name (kebab-case)
+     * @returns {string}
+     */
+    getPropertyPriority(property: string): string;
+    /**
+     * Set a property's value (and optionally its priority). An empty, null or undefined value removes the property
+     * instead, like the DOM.
+     * @param {string} property A CSS property name (kebab-case)
+     * @param {string} value The value, or '' to remove the property
+     * @param {string} [priority=''] "important" to mark it !important
+     * @returns {undefined}
+     */
+    setProperty(property: string, value: string, priority?: string): void;
+    /**
+     * Remove a property, returning the value it had (or '' when it was not set).
+     * @param {string} property A CSS property name (kebab-case)
+     * @returns {string}
+     */
+    removeProperty(property: string): string;
+    /**
+     * All the declarations as one CSS text string.
+     * @returns {string}
+     */
+    get cssText(): string;
+    /**
+     * Replace every declaration by parsing a CSS text string ("color: red; font-size: 12px !important;").
+     * @param {string} cssText
+     * @returns {undefined}
+     */
+    set cssText(cssText: string);
+}
+export default CSSStyleDeclarationService;

package/dist/services/CSSStyleDeclarationService.js

@@ -1,156 +1,156 @@
-'use strict'
-
-/**
- * @file Substitute for the DOM CSSStyleDeclaration Class (the object behind Element.style).
- * @author Joshua Heagle <joshuaheagle@gmail.com>
- * @version 1.0.0
- */
-require('core-js/modules/esnext.iterator.constructor.js')
-require('core-js/modules/esnext.iterator.for-each.js')
-require('core-js/modules/esnext.iterator.map.js')
-require('core-js/modules/esnext.map.delete-all.js')
-require('core-js/modules/esnext.map.every.js')
-require('core-js/modules/esnext.map.filter.js')
-require('core-js/modules/esnext.map.find.js')
-require('core-js/modules/esnext.map.find-key.js')
-require('core-js/modules/esnext.map.includes.js')
-require('core-js/modules/esnext.map.key-of.js')
-require('core-js/modules/esnext.map.map-keys.js')
-require('core-js/modules/esnext.map.map-values.js')
-require('core-js/modules/esnext.map.merge.js')
-require('core-js/modules/esnext.map.reduce.js')
-require('core-js/modules/esnext.map.some.js')
-require('core-js/modules/esnext.map.update.js')
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.CSSStyleDeclarationService = void 0
-/**
- * Simulate the behaviour of the CSSStyleDeclaration Class when there is no DOM available: an ordered map of CSS
- * property/value pairs, parsed from and serialized back to a cssText string. Values are stored and returned as
- * given, with no unit conversion, shorthand expansion or validation - this is a data structure, not a real CSS
- * engine. Named property access (declaration.backgroundColor, camelCase) is added on top of this by
- * createStyleDeclaration, which wraps an instance of this class in a Proxy.
- * @author Joshua Heagle <joshuaheagle@gmail.com>
- * @class
- */
-class CSSStyleDeclarationService {
-  /**
-   * @param {string} [cssText=''] Initial declarations, as CSS text ("color: red; font-size: 12px;")
-   * @constructor
-   */
-  constructor (cssText = '') {
-    this.properties = new Map()
-    this.cssText = cssText
-  }
-
-  /**
-   * How many properties are currently set.
-   * @returns {number}
-   */
-  get length () {
-    return this.properties.size
-  }
-
-  /**
-   * The name of the property at the given index, in the order it was set, or '' when there is none (matches the
-   * DOM's CSSStyleDeclaration, which is array-like).
-   * @param {number} index
-   * @returns {string}
-   */
-  item (index) {
-    return Array.from(this.properties.keys())[index] || ''
-  }
-
-  /**
-   * The value of the given property, or '' when it is not set.
-   * @param {string} property A CSS property name (kebab-case, e.g. "background-color")
-   * @returns {string}
-   */
-  getPropertyValue (property) {
-    const entry = this.properties.get(property)
-    return entry ? entry.value : ''
-  }
-
-  /**
-   * "important" when the property was set with !important, otherwise ''.
-   * @param {string} property A CSS property name (kebab-case)
-   * @returns {string}
-   */
-  getPropertyPriority (property) {
-    const entry = this.properties.get(property)
-    return entry ? entry.priority : ''
-  }
-
-  /**
-   * Set a property's value (and optionally its priority). An empty, null or undefined value removes the property
-   * instead, like the DOM.
-   * @param {string} property A CSS property name (kebab-case)
-   * @param {string} value The value, or '' to remove the property
-   * @param {string} [priority=''] "important" to mark it !important
-   * @returns {undefined}
-   */
-  setProperty (property, value, priority = '') {
-    if (value === '' || value === null || typeof value === 'undefined') {
-      this.removeProperty(property)
-      return
-    }
-    this.properties.set(property, {
-      value: String(value),
-      priority
-    })
-  }
-
-  /**
-   * Remove a property, returning the value it had (or '' when it was not set).
-   * @param {string} property A CSS property name (kebab-case)
-   * @returns {string}
-   */
-  removeProperty (property) {
-    const value = this.getPropertyValue(property)
-    this.properties.delete(property)
-    return value
-  }
-
-  /**
-   * All the declarations as one CSS text string.
-   * @returns {string}
-   */
-  get cssText () {
-    return Array.from(this.properties.entries()).map(([property, {
-      value,
-      priority
-    }]) => `${property}: ${value}${priority ? ` !${priority}` : ''};`).join(' ')
-  }
-
-  /**
-   * Replace every declaration by parsing a CSS text string ("color: red; font-size: 12px !important;").
-   * @param {string} cssText
-   * @returns {undefined}
-   */
-  set cssText (cssText) {
-    this.properties.clear()
-    String(cssText || '').split(';').forEach(declaration => {
-      const colon = declaration.indexOf(':')
-      if (colon < 0) {
-        return
-      }
-      const property = declaration.slice(0, colon).trim()
-      let value = declaration.slice(colon + 1).trim()
-      let priority = ''
-      const important = value.match(/!\s*important\s*$/i)
-      if (important && typeof important.index === 'number') {
-        priority = 'important'
-        value = value.slice(0, important.index).trim()
-      }
-      if (property && value) {
-        this.properties.set(property, {
-          value,
-          priority
-        })
-      }
-    })
-  }
-}
-exports.CSSStyleDeclarationService = CSSStyleDeclarationService
-exports.default = CSSStyleDeclarationService
+'use strict'
+
+/**
+ * @file Substitute for the DOM CSSStyleDeclaration Class (the object behind Element.style).
+ * @author Joshua Heagle <joshuaheagle@gmail.com>
+ * @version 1.0.0
+ */
+require('core-js/modules/esnext.iterator.constructor.js')
+require('core-js/modules/esnext.iterator.for-each.js')
+require('core-js/modules/esnext.iterator.map.js')
+require('core-js/modules/esnext.map.delete-all.js')
+require('core-js/modules/esnext.map.every.js')
+require('core-js/modules/esnext.map.filter.js')
+require('core-js/modules/esnext.map.find.js')
+require('core-js/modules/esnext.map.find-key.js')
+require('core-js/modules/esnext.map.includes.js')
+require('core-js/modules/esnext.map.key-of.js')
+require('core-js/modules/esnext.map.map-keys.js')
+require('core-js/modules/esnext.map.map-values.js')
+require('core-js/modules/esnext.map.merge.js')
+require('core-js/modules/esnext.map.reduce.js')
+require('core-js/modules/esnext.map.some.js')
+require('core-js/modules/esnext.map.update.js')
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.CSSStyleDeclarationService = void 0
+/**
+ * Simulate the behaviour of the CSSStyleDeclaration Class when there is no DOM available: an ordered map of CSS
+ * property/value pairs, parsed from and serialized back to a cssText string. Values are stored and returned as
+ * given, with no unit conversion, shorthand expansion or validation - this is a data structure, not a real CSS
+ * engine. Named property access (declaration.backgroundColor, camelCase) is added on top of this by
+ * createStyleDeclaration, which wraps an instance of this class in a Proxy.
+ * @author Joshua Heagle <joshuaheagle@gmail.com>
+ * @class
+ */
+class CSSStyleDeclarationService {
+  /**
+   * @param {string} [cssText=''] Initial declarations, as CSS text ("color: red; font-size: 12px;")
+   * @constructor
+   */
+  constructor (cssText = '') {
+    this.properties = new Map()
+    this.cssText = cssText
+  }
+
+  /**
+   * How many properties are currently set.
+   * @returns {number}
+   */
+  get length () {
+    return this.properties.size
+  }
+
+  /**
+   * The name of the property at the given index, in the order it was set, or '' when there is none (matches the
+   * DOM's CSSStyleDeclaration, which is array-like).
+   * @param {number} index
+   * @returns {string}
+   */
+  item (index) {
+    return Array.from(this.properties.keys())[index] || ''
+  }
+
+  /**
+   * The value of the given property, or '' when it is not set.
+   * @param {string} property A CSS property name (kebab-case, e.g. "background-color")
+   * @returns {string}
+   */
+  getPropertyValue (property) {
+    const entry = this.properties.get(property)
+    return entry ? entry.value : ''
+  }
+
+  /**
+   * "important" when the property was set with !important, otherwise ''.
+   * @param {string} property A CSS property name (kebab-case)
+   * @returns {string}
+   */
+  getPropertyPriority (property) {
+    const entry = this.properties.get(property)
+    return entry ? entry.priority : ''
+  }
+
+  /**
+   * Set a property's value (and optionally its priority). An empty, null or undefined value removes the property
+   * instead, like the DOM.
+   * @param {string} property A CSS property name (kebab-case)
+   * @param {string} value The value, or '' to remove the property
+   * @param {string} [priority=''] "important" to mark it !important
+   * @returns {undefined}
+   */
+  setProperty (property, value, priority = '') {
+    if (value === '' || value === null || typeof value === 'undefined') {
+      this.removeProperty(property)
+      return
+    }
+    this.properties.set(property, {
+      value: String(value),
+      priority
+    })
+  }
+
+  /**
+   * Remove a property, returning the value it had (or '' when it was not set).
+   * @param {string} property A CSS property name (kebab-case)
+   * @returns {string}
+   */
+  removeProperty (property) {
+    const value = this.getPropertyValue(property)
+    this.properties.delete(property)
+    return value
+  }
+
+  /**
+   * All the declarations as one CSS text string.
+   * @returns {string}
+   */
+  get cssText () {
+    return Array.from(this.properties.entries()).map(([property, {
+      value,
+      priority
+    }]) => `${property}: ${value}${priority ? ` !${priority}` : ''};`).join(' ')
+  }
+
+  /**
+   * Replace every declaration by parsing a CSS text string ("color: red; font-size: 12px !important;").
+   * @param {string} cssText
+   * @returns {undefined}
+   */
+  set cssText (cssText) {
+    this.properties.clear()
+    String(cssText || '').split(';').forEach(declaration => {
+      const colon = declaration.indexOf(':')
+      if (colon < 0) {
+        return
+      }
+      const property = declaration.slice(0, colon).trim()
+      let value = declaration.slice(colon + 1).trim()
+      let priority = ''
+      const important = value.match(/!\s*important\s*$/i)
+      if (important && typeof important.index === 'number') {
+        priority = 'important'
+        value = value.slice(0, important.index).trim()
+      }
+      if (property && value) {
+        this.properties.set(property, {
+          value,
+          priority
+        })
+      }
+    })
+  }
+}
+exports.CSSStyleDeclarationService = CSSStyleDeclarationService
+exports.default = CSSStyleDeclarationService