pseudo-dom 0.6.0 → 0.7.0

package/dist/services/HTMLCollectionService.js

@@ -1,8 +1,8 @@
 'use strict'
 
 require('core-js/modules/esnext.iterator.constructor.js')
-require('core-js/modules/esnext.iterator.filter.js')
 require('core-js/modules/esnext.iterator.find.js')
+require('core-js/modules/esnext.iterator.for-each.js')
 Object.defineProperty(exports, '__esModule', {
   value: true
 })
@@ -14,26 +14,43 @@ exports.HTMLCollectionService = void 0
  */
 const NodeService_1 = require('./NodeService')
 /**
- * Simulate the behaviour of the HTMLCollection Class when there is no DOM available: a live view of the element
- * children of a node, recomputed from its childNodes each time it is used rather than kept in sync as they change.
+ * Simulate the behaviour of the HTMLCollection Class when there is no DOM available: a live view of some of a node's
+ * element descendants, recomputed each time it is used rather than kept in sync as they change.
  * @author Joshua Heagle <joshuaheagle@gmail.com>
  * @class
  */
 class HTMLCollectionService {
   /**
-   * @param {NodeService} owner The node whose element children this is a live view of
+   * @param {NodeService} owner The node this is a live view of a part of
+   * @param {function(*): boolean} [predicate] Only elements which pass this are included (every element by default)
+   * @param {boolean} [deep=false] Include every matching descendant (true, like getElementsByTagName), not just the
+   * direct element children (false, like Element.children)
    * @constructor
    */
-  constructor (owner) {
+  constructor (owner, predicate = () => true, deep = false) {
     this.owner = owner
+    this.predicate = predicate
+    this.deep = deep
   }
 
   /**
-   * The current element children of the owner, in order.
+   * The current elements the collection holds, in tree order.
    * @returns {Array<PseudoNode>}
    */
   elements () {
-    return Array.from(this.owner.childNodes).filter(node => node.nodeType === NodeService_1.NodeService.ELEMENT_NODE)
+    const results = []
+    const visit = node => {
+      Array.from(node.childNodes).forEach(child => {
+        if (child.nodeType === NodeService_1.NodeService.ELEMENT_NODE && this.predicate(child)) {
+          results.push(child)
+        }
+        if (this.deep && child.nodeType === NodeService_1.NodeService.ELEMENT_NODE) {
+          visit(child)
+        }
+      })
+    }
+    visit(this.owner)
+    return results
   }
 
   /**
@@ -64,7 +81,7 @@ class HTMLCollectionService {
   }
 
   /**
-   * Iterate over the current element children.
+   * Iterate over the current elements.
    * @returns {Iterator}
    */
   [Symbol.iterator] () {

package/dist/services/HTMLCollectionService.min.js

@@ -1 +1 @@
-"use strict";require("core-js/modules/esnext.iterator.constructor.js"),require("core-js/modules/esnext.iterator.filter.js"),require("core-js/modules/esnext.iterator.find.js"),Object.defineProperty(exports,"__esModule",{value:!0}),exports.HTMLCollectionService=void 0;const NodeService_1=require("./NodeService");class HTMLCollectionService{constructor(e){this.owner=e}elements(){return Array.from(this.owner.childNodes).filter(e=>e.nodeType===NodeService_1.NodeService.ELEMENT_NODE)}get length(){return this.elements().length}item(e){return this.elements()[e]||null}namedItem(e){const t=this.elements();return t.find(t=>t.id===e)||t.find(t=>t.getAttribute("name")===e)||null}[Symbol.iterator](){return this.elements()[Symbol.iterator]()}}exports.HTMLCollectionService=HTMLCollectionService,exports.default=HTMLCollectionService;
+"use strict";require("core-js/modules/esnext.iterator.constructor.js"),require("core-js/modules/esnext.iterator.find.js"),require("core-js/modules/esnext.iterator.for-each.js"),Object.defineProperty(exports,"__esModule",{value:!0}),exports.HTMLCollectionService=void 0;const NodeService_1=require("./NodeService");class HTMLCollectionService{constructor(e,t=()=>!0,r=!1){this.owner=e,this.predicate=t,this.deep=r}elements(){const e=[],t=r=>{Array.from(r.childNodes).forEach(r=>{r.nodeType===NodeService_1.NodeService.ELEMENT_NODE&&this.predicate(r)&&e.push(r),this.deep&&r.nodeType===NodeService_1.NodeService.ELEMENT_NODE&&t(r)})};return t(this.owner),e}get length(){return this.elements().length}item(e){return this.elements()[e]||null}namedItem(e){const t=this.elements();return t.find(t=>t.id===e)||t.find(t=>t.getAttribute("name")===e)||null}[Symbol.iterator](){return this.elements()[Symbol.iterator]()}}exports.HTMLCollectionService=HTMLCollectionService,exports.default=HTMLCollectionService;

package/dist/services/HTMLElementService.d.ts

@@ -1,57 +1,57 @@
-/**
- * @file Substitute for the DOM HTMLElement Class.
- * @author Joshua Heagle <joshuaheagle@gmail.com>
- * @version 1.0.0
- */
-import { PseudoHTMLElement } from '../interfaces/PseudoHTMLElement';
-import { PseudoNode } from '../interfaces/PseudoNode';
-import { ElementService } from './ElementService';
-/**
- * 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 {Object} style - A container to define all applied inline-styles
- * @property {string} title - The title attribute which affects the text visible on hover
- */
-export declare class HTMLElementService extends ElementService implements Partial<PseudoHTMLElement> {
-    /**
-     * Simulate the HTMLElement object when the Dom is not available
-     * @param {Object} [elementOptions={}]
-     * @param {string} [elementOptions.tagName='']
-     * @param {PseudoNode|Object} [elementOptions.parent={}]
-     * @param {Array} [elementOptions.children=[]]
-     * @constructor
-     */
-    constructor({ tagName, parent, children }?: {
-        tagName?: string;
-        parent?: PseudoNode | null;
-        children?: Array<any>;
-    });
-    /**
-     * Whether this element can have the focus: form controls and links which are not disabled, and anything with a tabindex.
-     * @returns {boolean}
-     */
-    get canFocus(): boolean;
-    /**
-     * Click the element: a click event is sent to it, which bubbles and can be cancelled, like one from a user but a
-     * script made it (so it is not trusted). A disabled element does nothing.
-     */
-    click(): void;
-    /**
-     * Give the element the focus. The element which had it gets blur then focusout, and this one gets focus then
-     * focusin (blur and focus do not bubble, focusin and focusout do). Nothing happens when the element cannot have the
-     * focus or already has it.
-     */
-    focus(): void;
-    /**
-     * Take the focus away from the element, when it has it: it gets blur then focusout.
-     */
-    blur(): void;
-}
+/**
+ * @file Substitute for the DOM HTMLElement Class.
+ * @author Joshua Heagle <joshuaheagle@gmail.com>
+ * @version 1.0.0
+ */
+import { PseudoHTMLElement } from '../interfaces/PseudoHTMLElement';
+import { PseudoNode } from '../interfaces/PseudoNode';
+import { ElementService } from './ElementService';
+/**
+ * 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 {Object} style - A container to define all applied inline-styles
+ * @property {string} title - The title attribute which affects the text visible on hover
+ */
+export declare class HTMLElementService extends ElementService implements Partial<PseudoHTMLElement> {
+    /**
+     * Simulate the HTMLElement object when the Dom is not available
+     * @param {Object} [elementOptions={}]
+     * @param {string} [elementOptions.tagName='']
+     * @param {PseudoNode|Object} [elementOptions.parent={}]
+     * @param {Array} [elementOptions.children=[]]
+     * @constructor
+     */
+    constructor({ tagName, parent, children }?: {
+        tagName?: string;
+        parent?: PseudoNode | null;
+        children?: Array<any>;
+    });
+    /**
+     * Whether this element can have the focus: form controls and links which are not disabled, and anything with a tabindex.
+     * @returns {boolean}
+     */
+    get canFocus(): boolean;
+    /**
+     * Click the element: a click event is sent to it, which bubbles and can be cancelled, like one from a user but a
+     * script made it (so it is not trusted). A disabled element does nothing.
+     */
+    click(): void;
+    /**
+     * Give the element the focus. The element which had it gets blur then focusout, and this one gets focus then
+     * focusin (blur and focus do not bubble, focusin and focusout do). Nothing happens when the element cannot have the
+     * focus or already has it.
+     */
+    focus(): void;
+    /**
+     * Take the focus away from the element, when it has it: it gets blur then focusout.
+     */
+    blur(): void;
+}

package/dist/services/HTMLElementService.js

@@ -1,163 +1,163 @@
-'use strict'
-
-const __importDefault = void 0 && (void 0).__importDefault || function (mod) {
-  return mod && mod.__esModule
-    ? mod
-    : {
-        default: mod
-      }
-}
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.HTMLElementService = void 0
-const ElementService_1 = require('./ElementService')
-const createEvent_1 = __importDefault(require('../factories/createEvent'))
-const activeElement_1 = require('../functions/activeElement')
-/**
- * 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 {Object} style - A container to define all applied inline-styles
- * @property {string} title - The title attribute which affects the text visible on hover
- */
-class HTMLElementService extends ElementService_1.ElementService {
-  /**
-   * Simulate the HTMLElement object when the Dom is not available
-   * @param {Object} [elementOptions={}]
-   * @param {string} [elementOptions.tagName='']
-   * @param {PseudoNode|Object} [elementOptions.parent={}]
-   * @param {Array} [elementOptions.children=[]]
-   * @constructor
-   */
-  constructor ({
-    tagName = '',
-    parent = null,
-    children = []
-  } = {}) {
-    super({
-      tagName,
-      attributes: [{
-        name: 'hidden',
-        value: false
-      }, {
-        name: 'offsetHeight',
-        value: 0
-      }, {
-        name: 'offsetLeft',
-        value: 0
-      }, {
-        name: 'offsetParent',
-        value: null
-      }, {
-        name: 'offsetTop',
-        value: 0
-      }, {
-        name: 'offsetWidth',
-        value: 0
-      }, {
-        name: 'style',
-        value: {}
-      }, {
-        name: 'title',
-        value: ''
-      }],
-      parent,
-      children
-    })
-  }
-
-  /**
-   * Whether this element can have the focus: form controls and links which are not disabled, and anything with a tabindex.
-   * @returns {boolean}
-   */
-  get canFocus () {
-    if (this.hasAttribute('disabled')) {
-      return false
-    }
-    switch (this.tagName) {
-      case 'button':
-      case 'select':
-      case 'textarea':
-        return true
-      case 'input':
-        return String(this.getAttribute('type') || '').toLowerCase() !== 'hidden'
-      case 'a':
-        return this.hasAttribute('href') || this.hasAttribute('tabindex')
-      default:
-        return this.hasAttribute('tabindex')
-    }
-  }
-
-  /**
-   * Click the element: a click event is sent to it, which bubbles and can be cancelled, like one from a user but a
-   * script made it (so it is not trusted). A disabled element does nothing.
-   */
-  click () {
-    if (this.hasAttribute('disabled')) {
-      return
-    }
-    this.dispatchEvent((0, createEvent_1.default)('click', {}, {
-      browser: true
-    }))
-  }
-
-  /**
-   * Give the element the focus. The element which had it gets blur then focusout, and this one gets focus then
-   * focusin (blur and focus do not bubble, focusin and focusout do). Nothing happens when the element cannot have the
-   * focus or already has it.
-   */
-  focus () {
-    const root = this.getRootNode()
-    const previous = (0, activeElement_1.getActiveElement)(root)
-    if (!this.canFocus || previous === this) {
-      return
-    }
-    const send = (target, type, relatedTarget) => {
-      target.dispatchEvent((0, createEvent_1.default)(type, {
-        relatedTarget
-      }, {
-        browser: true,
-        trusted: true
-      }))
-    }
-    if (previous) {
-      send(previous, 'blur', this)
-      send(previous, 'focusout', this)
-    }
-    (0, activeElement_1.setActiveElement)(root, this)
-    send(this, 'focus', previous)
-    send(this, 'focusin', previous)
-  }
-
-  /**
-   * Take the focus away from the element, when it has it: it gets blur then focusout.
-   */
-  blur () {
-    const root = this.getRootNode()
-    if ((0, activeElement_1.getActiveElement)(root) !== this) {
-      return
-    }
-    (0, activeElement_1.setActiveElement)(root, null)
-    this.dispatchEvent((0, createEvent_1.default)('blur', {
-      relatedTarget: null
-    }, {
-      browser: true,
-      trusted: true
-    }))
-    this.dispatchEvent((0, createEvent_1.default)('focusout', {
-      relatedTarget: null
-    }, {
-      browser: true,
-      trusted: true
-    }))
-  }
-}
-exports.HTMLElementService = HTMLElementService
+'use strict'
+
+const __importDefault = void 0 && (void 0).__importDefault || function (mod) {
+  return mod && mod.__esModule
+    ? mod
+    : {
+        default: mod
+      }
+}
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.HTMLElementService = void 0
+const ElementService_1 = require('./ElementService')
+const createEvent_1 = __importDefault(require('../factories/createEvent'))
+const activeElement_1 = require('../functions/activeElement')
+/**
+ * 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 {Object} style - A container to define all applied inline-styles
+ * @property {string} title - The title attribute which affects the text visible on hover
+ */
+class HTMLElementService extends ElementService_1.ElementService {
+  /**
+   * Simulate the HTMLElement object when the Dom is not available
+   * @param {Object} [elementOptions={}]
+   * @param {string} [elementOptions.tagName='']
+   * @param {PseudoNode|Object} [elementOptions.parent={}]
+   * @param {Array} [elementOptions.children=[]]
+   * @constructor
+   */
+  constructor ({
+    tagName = '',
+    parent = null,
+    children = []
+  } = {}) {
+    super({
+      tagName,
+      attributes: [{
+        name: 'hidden',
+        value: false
+      }, {
+        name: 'offsetHeight',
+        value: 0
+      }, {
+        name: 'offsetLeft',
+        value: 0
+      }, {
+        name: 'offsetParent',
+        value: null
+      }, {
+        name: 'offsetTop',
+        value: 0
+      }, {
+        name: 'offsetWidth',
+        value: 0
+      }, {
+        name: 'style',
+        value: {}
+      }, {
+        name: 'title',
+        value: ''
+      }],
+      parent,
+      children
+    })
+  }
+
+  /**
+   * Whether this element can have the focus: form controls and links which are not disabled, and anything with a tabindex.
+   * @returns {boolean}
+   */
+  get canFocus () {
+    if (this.hasAttribute('disabled')) {
+      return false
+    }
+    switch (this.tagName) {
+      case 'button':
+      case 'select':
+      case 'textarea':
+        return true
+      case 'input':
+        return String(this.getAttribute('type') || '').toLowerCase() !== 'hidden'
+      case 'a':
+        return this.hasAttribute('href') || this.hasAttribute('tabindex')
+      default:
+        return this.hasAttribute('tabindex')
+    }
+  }
+
+  /**
+   * Click the element: a click event is sent to it, which bubbles and can be cancelled, like one from a user but a
+   * script made it (so it is not trusted). A disabled element does nothing.
+   */
+  click () {
+    if (this.hasAttribute('disabled')) {
+      return
+    }
+    this.dispatchEvent((0, createEvent_1.default)('click', {}, {
+      browser: true
+    }))
+  }
+
+  /**
+   * Give the element the focus. The element which had it gets blur then focusout, and this one gets focus then
+   * focusin (blur and focus do not bubble, focusin and focusout do). Nothing happens when the element cannot have the
+   * focus or already has it.
+   */
+  focus () {
+    const root = this.getRootNode()
+    const previous = (0, activeElement_1.getActiveElement)(root)
+    if (!this.canFocus || previous === this) {
+      return
+    }
+    const send = (target, type, relatedTarget) => {
+      target.dispatchEvent((0, createEvent_1.default)(type, {
+        relatedTarget
+      }, {
+        browser: true,
+        trusted: true
+      }))
+    }
+    if (previous) {
+      send(previous, 'blur', this)
+      send(previous, 'focusout', this)
+    }
+    (0, activeElement_1.setActiveElement)(root, this)
+    send(this, 'focus', previous)
+    send(this, 'focusin', previous)
+  }
+
+  /**
+   * Take the focus away from the element, when it has it: it gets blur then focusout.
+   */
+  blur () {
+    const root = this.getRootNode()
+    if ((0, activeElement_1.getActiveElement)(root) !== this) {
+      return
+    }
+    (0, activeElement_1.setActiveElement)(root, null)
+    this.dispatchEvent((0, createEvent_1.default)('blur', {
+      relatedTarget: null
+    }, {
+      browser: true,
+      trusted: true
+    }))
+    this.dispatchEvent((0, createEvent_1.default)('focusout', {
+      relatedTarget: null
+    }, {
+      browser: true,
+      trusted: true
+    }))
+  }
+}
+exports.HTMLElementService = HTMLElementService

package/dist/services/HTMLSlotElementService.d.ts

@@ -1,4 +1,4 @@
-import { PseudoHTMLSlotElement } from '../interfaces/PseudoHTMLSlotElement';
-import { HTMLElementService } from './HTMLElementService';
-export declare class HTMLSlotElementService extends HTMLElementService implements Partial<PseudoHTMLSlotElement> {
-}
+import { PseudoHTMLSlotElement } from '../interfaces/PseudoHTMLSlotElement';
+import { HTMLElementService } from './HTMLElementService';
+export declare class HTMLSlotElementService extends HTMLElementService implements Partial<PseudoHTMLSlotElement> {
+}

package/dist/services/HTMLSlotElementService.js

@@ -1,9 +1,9 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.HTMLSlotElementService = void 0
-const HTMLElementService_1 = require('./HTMLElementService')
-class HTMLSlotElementService extends HTMLElementService_1.HTMLElementService {}
-exports.HTMLSlotElementService = HTMLSlotElementService
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.HTMLSlotElementService = void 0
+const HTMLElementService_1 = require('./HTMLElementService')
+class HTMLSlotElementService extends HTMLElementService_1.HTMLElementService {}
+exports.HTMLSlotElementService = HTMLSlotElementService

package/dist/services/InputEventService.d.ts

@@ -1,41 +1,41 @@
-/**
- * @file Substitute for the DOM InputEvent Class.
- * @author Joshua Heagle <joshuaheagle@gmail.com>
- * @version 1.0.0
- */
-import { UIEventInit, UIEventService } from './UIEventService';
-/**
- * The options for creating an input event, on top of the ones every UI event has.
- * @typedef {Object} InputEventInit
- * @property {string|null} [data=null] The characters which were entered
- * @property {string} [inputType=''] What kind of change it was, such as insertText
- * @property {boolean} [isComposing=false]
- */
-export type InputEventInit = UIEventInit & {
-    data?: string | null;
-    inputType?: string;
-    isComposing?: boolean;
-};
-/**
- * Simulate the behaviour of the InputEvent Class when there is no DOM available.
- * @author Joshua Heagle <joshuaheagle@gmail.com>
- * @class
- * @augments UIEventService
- * @property {string|null} data
- * @property {string} inputType
- * @property {boolean} isComposing
- */
-export declare class InputEventService extends UIEventService {
-    private readonly inputData;
-    private readonly kind;
-    private readonly composing;
-    /**
-     * @param {string} [typeArg=''] The type of the event
-     * @param {InputEventInit} [init={}] The options for the event
-     * @constructor
-     */
-    constructor(typeArg?: string, init?: InputEventInit);
-    get data(): string | null;
-    get inputType(): string;
-    get isComposing(): boolean;
-}
+/**
+ * @file Substitute for the DOM InputEvent Class.
+ * @author Joshua Heagle <joshuaheagle@gmail.com>
+ * @version 1.0.0
+ */
+import { UIEventInit, UIEventService } from './UIEventService';
+/**
+ * The options for creating an input event, on top of the ones every UI event has.
+ * @typedef {Object} InputEventInit
+ * @property {string|null} [data=null] The characters which were entered
+ * @property {string} [inputType=''] What kind of change it was, such as insertText
+ * @property {boolean} [isComposing=false]
+ */
+export type InputEventInit = UIEventInit & {
+    data?: string | null;
+    inputType?: string;
+    isComposing?: boolean;
+};
+/**
+ * Simulate the behaviour of the InputEvent Class when there is no DOM available.
+ * @author Joshua Heagle <joshuaheagle@gmail.com>
+ * @class
+ * @augments UIEventService
+ * @property {string|null} data
+ * @property {string} inputType
+ * @property {boolean} isComposing
+ */
+export declare class InputEventService extends UIEventService {
+    private readonly inputData;
+    private readonly kind;
+    private readonly composing;
+    /**
+     * @param {string} [typeArg=''] The type of the event
+     * @param {InputEventInit} [init={}] The options for the event
+     * @constructor
+     */
+    constructor(typeArg?: string, init?: InputEventInit);
+    get data(): string | null;
+    get inputType(): string;
+    get isComposing(): boolean;
+}