pseudo-dom 0.5.0 → 0.6.0

package/dist/interfaces/PseudoElement.d.ts

@@ -470,9 +470,10 @@ export interface PseudoElement extends PseudoNode {
      */
     set ariaValueText(value: string);
     /**
-     * Inserts a set of Node objects or strings in the children list of the Element's parent, just after the Element.
+     * Inserts a set of Node objects or strings in the children list of the Element's parent, just after the Element. Does
+     * nothing when the element has no parent.
      */
-    after(...nodes: PseudoNode[]): void;
+    after(...nodes: Array<PseudoNode | string>): void;
     /**
      * A shortcut method to create and run an animation on an element. Returns the created Animation object instance.
      */
@@ -485,7 +486,7 @@ export interface PseudoElement extends PseudoNode {
     /**
      * Inserts a set of Node objects or strings after the last child of the element.
      */
-    append(...params: PseudoNode[]): void;
+    append(...nodes: Array<PseudoNode | string>): void;
     /**
      * Attaches a shadow DOM tree to the specified element and returns a reference to its ShadowRoot.
      */
@@ -496,9 +497,10 @@ export interface PseudoElement extends PseudoNode {
         slotAssignment: string;
     }): PseudoShadowRoot;
     /**
-     * Inserts a set of Node objects or strings in the children list of the Element's parent, just before the Element.
+     * Inserts a set of Node objects or strings in the children list of the Element's parent, just before the Element. Does
+     * nothing when the element has no parent.
      */
-    before(...params: PseudoNode[]): void;
+    before(...nodes: Array<PseudoNode | string>): void;
     /**
      * Returns whether an element is  expected to be visible or not based on configurable checks.
      */
@@ -572,17 +574,25 @@ export interface PseudoElement extends PseudoNode {
      */
     hasPointerCapture(): string;
     /**
-     * Inserts a given element node at a given position relative to the element it is invoked upon.
+     * Inserts a given element at a given position relative to the element it is invoked upon.
+     * @param {string} position beforebegin, afterbegin, beforeend or afterend
+     * @param {PseudoElement} element The element to insert
+     * @returns {PseudoElement|null} The inserted element, or null when the position needs a parent this element does not have
      */
-    insertAdjacentElement(): string;
+    insertAdjacentElement(position: string, element: PseudoElement): PseudoElement | null;
     /**
-     * Parses the text as HTML or XML and inserts the resulting nodes into the tree in the position given.
+     * Parses the text as HTML or XML and inserts the resulting nodes into the tree in the position given. Not implemented
+     * yet (HTML parsing is out of scope for now).
+     * @param {string} position beforebegin, afterbegin, beforeend or afterend
+     * @param {string} text The markup to parse
      */
-    insertAdjacentHTML(): string;
+    insertAdjacentHTML(position: string, text: string): void;
     /**
-     * Inserts a given text node at a given position relative to the element it is invoked upon.
+     * Inserts a given text at a given position relative to the element it is invoked upon.
+     * @param {string} position beforebegin, afterbegin, beforeend or afterend
+     * @param {string} text The text to insert
      */
-    insertAdjacentText(): string;
+    insertAdjacentText(position: string, text: string): void;
     /**
      * Returns a boolean value indicating whether or not the element would be selected by the specified selector string.
      */
@@ -590,7 +600,7 @@ export interface PseudoElement extends PseudoNode {
     /**
      * Inserts a set of Node objects or strings before the first child of the element.
      */
-    prepend(): string;
+    prepend(...nodes: Array<PseudoNode | string>): void;
     /**
      * Returns the first Node which matches the specified selector string relative to the element.
      */
@@ -604,9 +614,9 @@ export interface PseudoElement extends PseudoNode {
      */
     releasePointerCapture(): string;
     /**
-     * Removes the element from the children list of its parent.
+     * Removes the element from the children list of its parent. Does nothing when it has no parent.
      */
-    remove(): string;
+    remove(): void;
     /**
      * Removes the named attribute from the current node.
      */
@@ -622,11 +632,12 @@ export interface PseudoElement extends PseudoNode {
     /**
      * Replaces the existing children of a Node with a specified new set of children.
      */
-    replaceChildren(): string;
+    replaceChildren(...nodes: Array<PseudoNode | string>): void;
     /**
-     * Replaces the element in the children list of its parent with a set of Node objects or strings.
+     * Replaces the element in the children list of its parent with a set of Node objects or strings. Does nothing when it
+     * has no parent.
      */
-    replaceWith(): string;
+    replaceWith(...nodes: Array<PseudoNode | string>): void;
     /**
      * Asynchronously asks the browser to make the element fullscreen.
      */

package/dist/interfaces/PseudoHTMLCollection.d.ts

@@ -1,2 +1,23 @@
-export interface PseudoHTMLCollection {
+import { PseudoElement } from './PseudoElement';
+/**
+ * A live collection of an element's (or a document's / document fragment's) element children: it is not a snapshot,
+ * reading it after the tree changes reflects the change.
+ */
+export interface PseudoHTMLCollection extends Iterable<PseudoElement> {
+    /**
+     * How many elements are in the collection.
+     */
+    get length(): number;
+    /**
+     * The element at the given index, or null when there is none.
+     * @param {number} index
+     * @returns {PseudoElement|null}
+     */
+    item(index: number): PseudoElement | null;
+    /**
+     * The element whose id, or whose name attribute, is the given value, or null when there is none.
+     * @param {string} name
+     * @returns {PseudoElement|null}
+     */
+    namedItem(name: string): PseudoElement | null;
 }

package/dist/services/ElementService.d.ts

@@ -4,10 +4,11 @@
  * @version 1.0.0
  */
 import { PseudoNode } from '../interfaces/PseudoNode';
-import { NodeService } from './NodeService';
 import { PseudoElement } from '../interfaces/PseudoElement';
+import { NodeService } from './NodeService';
 import { PseudoNamedNodeMap } from '../interfaces/PseudoNamedNodeMap';
 import { PseudoDOMTokenList } from '../interfaces/PseudoDOMTokenList';
+import { PseudoHTMLCollection } from '../interfaces/PseudoHTMLCollection';
 type attribute = {
     name: string;
     value: any;
@@ -80,6 +81,68 @@ export declare class ElementService extends NodeService implements Partial<Pseud
      * 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(): PseudoHTMLCollection;
+    /**
+     * How many element children this element has.
+     * @returns {number}
+     */
+    get childElementCount(): number;
+    /**
+     * The first child of this element which is an element, or null when there is none.
+     * @returns {PseudoElement|null}
+     */
+    get firstElementChild(): PseudoElement | null;
+    /**
+     * The last child of this element which is an element, or null when there is none.
+     * @returns {PseudoElement|null}
+     */
+    get lastElementChild(): PseudoElement | null;
+    /**
+     * The sibling after this one which is an element, or null when there is none.
+     * @returns {PseudoElement|null}
+     */
+    get nextElementSibling(): PseudoElement | null;
+    /**
+     * The sibling before this one which is an element, or null when there is none.
+     * @returns {PseudoElement|null}
+     */
+    get previousElementSibling(): PseudoElement | null;
+    /**
+     * 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
+     * @throws {Error} When the position is not one of the four above
+     */
+    insertAdjacentElement(position: string, element: PseudoElement): PseudoElement | null;
+    /**
+     * 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
+     * @throws {Error} When the position is not one of the four above
+     */
+    insertAdjacentText(position: string, text: string): void;
+    /**
+     * 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
+     * @throws {Error} When the position is not one of the four above
+     */
+    private insertAdjacent;
+    /**
+     * 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
+     * @throws {Error}
+     */
+    insertAdjacentHTML(position: string, text: string): void;
     applyDefaultEvent(): Function;
     /**
      * An element which is added as a child gets its default events (for example a submit button submits its form).

package/dist/services/ElementService.js

@@ -23,6 +23,7 @@ const AttrService_1 = require('./AttrService')
 const DOMTokenListService_1 = require('./DOMTokenListService')
 const NamedNodeMapService_1 = require('./NamedNodeMapService')
 const getParentNodesFromAttribute_1 = __importDefault(require('../functions/getParentNodesFromAttribute'))
+const HTMLCollectionService_1 = require('./HTMLCollectionService')
 const cloneObject_1 = __importDefault(require('si-funciona/dist/helpers/objects/cloneObject'))
 const isEqual_1 = __importDefault(require('si-funciona/dist/helpers/objects/isEqual'))
 /**
@@ -184,6 +185,128 @@ 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)
+  }
+
+  /**
+   * How many element children this element has.
+   * @returns {number}
+   */
+  get childElementCount () {
+    return this.children.length
+  }
+
+  /**
+   * 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)
+  }
+
+  /**
+   * 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
+    return elementChildren.item(elementChildren.length - 1)
+  }
+
+  /**
+   * The sibling after this one which is an element, or null when there is none.
+   * @returns {PseudoElement|null}
+   */
+  get nextElementSibling () {
+    let sibling = this.nextSibling
+    while (sibling && sibling.nodeType !== NodeService_1.NodeService.ELEMENT_NODE) {
+      sibling = sibling.nextSibling
+    }
+    return sibling
+  }
+
+  /**
+   * The sibling before this one which is an element, or null when there is none.
+   * @returns {PseudoElement|null}
+   */
+  get previousElementSibling () {
+    let sibling = this.previousSibling
+    while (sibling && sibling.nodeType !== NodeService_1.NodeService.ELEMENT_NODE) {
+      sibling = sibling.previousSibling
+    }
+    return sibling
+  }
+
+  /**
+   * 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
+   * @throws {Error} When the position is not one of the four above
+   */
+  insertAdjacentElement (position, element) {
+    return this.insertAdjacent(position, element)
+  }
+
+  /**
+   * 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
+   * @throws {Error} When the position is not one of the four above
+   */
+  insertAdjacentText (position, text) {
+    this.insertAdjacent(position, text)
+  }
+
+  /**
+   * 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
+   * @throws {Error} When the position is not one of the four above
+   */
+  insertAdjacent (position, node) {
+    switch (position) {
+      case 'beforebegin':
+        if (!this.parentNode) {
+          return null
+        }
+        this.before(node)
+        return node
+      case 'afterbegin':
+        this.prepend(node)
+        return node
+      case 'beforeend':
+        this.append(node)
+        return node
+      case 'afterend':
+        if (!this.parentNode) {
+          return null
+        }
+        this.after(node)
+        return node
+      default:
+        throw new Error(`"${position}" is not one of beforebegin, afterbegin, beforeend or afterend.`)
+    }
+  }
+
+  /**
+   * 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
+   * @throws {Error}
+   */
+  insertAdjacentHTML (position, text) {
+    throw new Error('ElementService.insertAdjacentHTML() is not implemented yet.')
+  }
+
   applyDefaultEvent () {
     let callback = event => undefined
     if (this.defaultEventApplied) {

package/dist/services/ElementService.min.js

@@ -1 +1 @@
-"use strict";require("core-js/modules/esnext.iterator.constructor.js"),require("core-js/modules/esnext.iterator.every.js"),require("core-js/modules/esnext.iterator.find.js"),require("core-js/modules/esnext.iterator.for-each.js"),require("core-js/modules/esnext.iterator.map.js"),require("core-js/modules/esnext.iterator.some.js");var __importDefault=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.ElementService=void 0;const createEvent_1=__importDefault(require("../factories/createEvent")),NodeService_1=require("./NodeService"),AttrService_1=require("./AttrService"),DOMTokenListService_1=require("./DOMTokenListService"),NamedNodeMapService_1=require("./NamedNodeMapService"),getParentNodesFromAttribute_1=__importDefault(require("../functions/getParentNodesFromAttribute")),cloneObject_1=__importDefault(require("si-funciona/dist/helpers/objects/cloneObject")),isEqual_1=__importDefault(require("si-funciona/dist/helpers/objects/isEqual"));class ElementService extends NodeService_1.NodeService{constructor({tagName:e="",attributes:t=[],parent:r=null,children:i=[]}={}){super(),this.defaultEventApplied=!1,this.tokenList=new DOMTokenListService_1.DOMTokenListService,this.tag=e,this.attributeList=t.concat([{name:"className",value:""},{name:"id",value:""},{name:"innerHTML",value:""}]),this.propertyAttributes=this.attributeList.map(({name:e})=>e),this.attributeList.forEach(({name:e,value:t})=>{this[e]=t}),i.forEach(e=>{if(!e||"number"!=typeof e.nodeType)throw new TypeError("The children of an element must be nodes.");this.appendChild(e)}),r&&r.appendChild(this)}currentAttributes(){return this.attributeList.map(({name:e,value:t})=>({name:e,value:this.propertyAttributes.indexOf(e)>=0?this[e]:t}))}get nodeName(){return this.tag}cloneShallow(){const e=new this.constructor({tagName:this.tag});return e.attributeList.length=0,this.currentAttributes().forEach(({name:t,value:r})=>{const i="object"==typeof r&&null!==r?(0,cloneObject_1.default)(r):r;e.attributeList.push({name:t,value:i}),e.propertyAttributes.indexOf(t)>=0&&(e[t]=i)}),e.ownerDocumentStore=this.ownerDocumentStore,e}equalsShallow(e){const t=this.currentAttributes(),r=e.currentAttributes();return this.nodeName===e.nodeName&&t.length===r.length&&t.every(({name:e,value:t})=>{const i=r.find(t=>t.name===e);return void 0!==i&&(0,isEqual_1.default)(t,i.value)})}get tagName(){return this.tag}get nodeType(){return NodeService_1.NodeService.ELEMENT_NODE}get attributes(){return new NamedNodeMapService_1.NamedNodeMapService(this.currentAttributes().map(({name:e,value:t})=>new AttrService_1.AttrService(e,String(t),this)))}get classList(){return this.tokenList}get className(){return this.tokenList.value}set className(e){this.tokenList.value=e}applyDefaultEvent(){let e=e=>{};if(this.defaultEventApplied)return e;switch(this.tagName){case"button":case"input":e=e=>{const t=String(this.getAttribute("type")||this.type||"").toLowerCase(),r="button"===this.tagName?"button"!==t&&"reset"!==t:/^(submit|image)$/.test(t),i=(0,getParentNodesFromAttribute_1.default)("tagName","form",this);r&&i.length&&!this.hasAttribute("disabled")&&i[i.length-1].dispatchEvent((0,createEvent_1.default)("submit",{},{browser:!0,trusted:e.isTrusted}))},super.setDefaultEvent("click",e),this.defaultEventApplied=!0}return e}childInserted(e){"function"==typeof e.applyDefaultEvent&&e.applyDefaultEvent()}hasAttribute(e){return this.attributeList.some(({name:t})=>t===e)}setAttribute(e,t){const r=this.attributeList.find(({name:t})=>t===e);r?r.value=t:this.attributeList.push({name:e,value:t}),this.propertyAttributes.indexOf(e)>=0&&(this[e]=t)}getAttribute(e){const t=this.currentAttributes().find(({name:t})=>t===e);return t?t.value:null}removeAttribute(e){const t=this.attributeList.findIndex(({name:t})=>t===e);t>=0&&this.attributeList.splice(t,1)}}exports.ElementService=ElementService;
+"use strict";require("core-js/modules/esnext.iterator.constructor.js"),require("core-js/modules/esnext.iterator.every.js"),require("core-js/modules/esnext.iterator.find.js"),require("core-js/modules/esnext.iterator.for-each.js"),require("core-js/modules/esnext.iterator.map.js"),require("core-js/modules/esnext.iterator.some.js");var __importDefault=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.ElementService=void 0;const createEvent_1=__importDefault(require("../factories/createEvent")),NodeService_1=require("./NodeService"),AttrService_1=require("./AttrService"),DOMTokenListService_1=require("./DOMTokenListService"),NamedNodeMapService_1=require("./NamedNodeMapService"),getParentNodesFromAttribute_1=__importDefault(require("../functions/getParentNodesFromAttribute")),HTMLCollectionService_1=require("./HTMLCollectionService"),cloneObject_1=__importDefault(require("si-funciona/dist/helpers/objects/cloneObject")),isEqual_1=__importDefault(require("si-funciona/dist/helpers/objects/isEqual"));class ElementService extends NodeService_1.NodeService{constructor({tagName:e="",attributes:t=[],parent:r=null,children:i=[]}={}){super(),this.defaultEventApplied=!1,this.tokenList=new DOMTokenListService_1.DOMTokenListService,this.tag=e,this.attributeList=t.concat([{name:"className",value:""},{name:"id",value:""},{name:"innerHTML",value:""}]),this.propertyAttributes=this.attributeList.map(({name:e})=>e),this.attributeList.forEach(({name:e,value:t})=>{this[e]=t}),i.forEach(e=>{if(!e||"number"!=typeof e.nodeType)throw new TypeError("The children of an element must be nodes.");this.appendChild(e)}),r&&r.appendChild(this)}currentAttributes(){return this.attributeList.map(({name:e,value:t})=>({name:e,value:this.propertyAttributes.indexOf(e)>=0?this[e]:t}))}get nodeName(){return this.tag}cloneShallow(){const e=new this.constructor({tagName:this.tag});return e.attributeList.length=0,this.currentAttributes().forEach(({name:t,value:r})=>{const i="object"==typeof r&&null!==r?(0,cloneObject_1.default)(r):r;e.attributeList.push({name:t,value:i}),e.propertyAttributes.indexOf(t)>=0&&(e[t]=i)}),e.ownerDocumentStore=this.ownerDocumentStore,e}equalsShallow(e){const t=this.currentAttributes(),r=e.currentAttributes();return this.nodeName===e.nodeName&&t.length===r.length&&t.every(({name:e,value:t})=>{const i=r.find(t=>t.name===e);return void 0!==i&&(0,isEqual_1.default)(t,i.value)})}get tagName(){return this.tag}get nodeType(){return NodeService_1.NodeService.ELEMENT_NODE}get attributes(){return new NamedNodeMapService_1.NamedNodeMapService(this.currentAttributes().map(({name:e,value:t})=>new AttrService_1.AttrService(e,String(t),this)))}get classList(){return this.tokenList}get className(){return this.tokenList.value}set className(e){this.tokenList.value=e}get children(){return new HTMLCollectionService_1.HTMLCollectionService(this)}get childElementCount(){return this.children.length}get firstElementChild(){return this.children.item(0)}get lastElementChild(){const e=this.children;return e.item(e.length-1)}get nextElementSibling(){let e=this.nextSibling;for(;e&&e.nodeType!==NodeService_1.NodeService.ELEMENT_NODE;)e=e.nextSibling;return e}get previousElementSibling(){let e=this.previousSibling;for(;e&&e.nodeType!==NodeService_1.NodeService.ELEMENT_NODE;)e=e.previousSibling;return e}insertAdjacentElement(e,t){return this.insertAdjacent(e,t)}insertAdjacentText(e,t){this.insertAdjacent(e,t)}insertAdjacent(e,t){switch(e){case"beforebegin":return this.parentNode?(this.before(t),t):null;case"afterbegin":return this.prepend(t),t;case"beforeend":return this.append(t),t;case"afterend":return this.parentNode?(this.after(t),t):null;default:throw new Error(`"${e}" is not one of beforebegin, afterbegin, beforeend or afterend.`)}}insertAdjacentHTML(e,t){throw new Error("ElementService.insertAdjacentHTML() is not implemented yet.")}applyDefaultEvent(){let e=e=>{};if(this.defaultEventApplied)return e;switch(this.tagName){case"button":case"input":e=e=>{const t=String(this.getAttribute("type")||this.type||"").toLowerCase(),r="button"===this.tagName?"button"!==t&&"reset"!==t:/^(submit|image)$/.test(t),i=(0,getParentNodesFromAttribute_1.default)("tagName","form",this);r&&i.length&&!this.hasAttribute("disabled")&&i[i.length-1].dispatchEvent((0,createEvent_1.default)("submit",{},{browser:!0,trusted:e.isTrusted}))},super.setDefaultEvent("click",e),this.defaultEventApplied=!0}return e}childInserted(e){"function"==typeof e.applyDefaultEvent&&e.applyDefaultEvent()}hasAttribute(e){return this.attributeList.some(({name:t})=>t===e)}setAttribute(e,t){const r=this.attributeList.find(({name:t})=>t===e);r?r.value=t:this.attributeList.push({name:e,value:t}),this.propertyAttributes.indexOf(e)>=0&&(this[e]=t)}getAttribute(e){const t=this.currentAttributes().find(({name:t})=>t===e);return t?t.value:null}removeAttribute(e){const t=this.attributeList.findIndex(({name:t})=>t===e);t>=0&&this.attributeList.splice(t,1)}}exports.ElementService=ElementService;

package/dist/services/HTMLCollectionService.d.ts

@@ -1,3 +1,49 @@
+/**
+ * @file Substitute for the DOM HTMLCollection Class.
+ * @author Joshua Heagle <joshuaheagle@gmail.com>
+ * @version 1.0.0
+ */
+import { NodeService } from './NodeService';
 import { PseudoHTMLCollection } from '../interfaces/PseudoHTMLCollection';
+/**
+ * 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.
+ * @author Joshua Heagle <joshuaheagle@gmail.com>
+ * @class
+ */
 export declare class HTMLCollectionService implements PseudoHTMLCollection {
+    private readonly owner;
+    /**
+     * @param {NodeService} owner The node whose element children this is a live view of
+     * @constructor
+     */
+    constructor(owner: NodeService);
+    /**
+     * The current element children of the owner, in order.
+     * @returns {Array<PseudoNode>}
+     */
+    private elements;
+    /**
+     * How many elements are in the collection right now.
+     * @returns {number}
+     */
+    get length(): number;
+    /**
+     * The element at the given index, or null when there is none.
+     * @param {number} index
+     * @returns {*}
+     */
+    item(index: number): any | null;
+    /**
+     * The element whose id, or (failing that) whose name attribute, is the given value, or null when there is none.
+     * @param {string} name
+     * @returns {*}
+     */
+    namedItem(name: string): any | null;
+    /**
+     * Iterate over the current element children.
+     * @returns {Iterator}
+     */
+    [Symbol.iterator](): Iterator<any>;
 }
+export default HTMLCollectionService;

package/dist/services/HTMLCollectionService.js

@@ -1,8 +1,75 @@
 '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: true
 })
 exports.HTMLCollectionService = void 0
-class HTMLCollectionService {}
+/**
+ * @file Substitute for the DOM HTMLCollection Class.
+ * @author Joshua Heagle <joshuaheagle@gmail.com>
+ * @version 1.0.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.
+ * @author Joshua Heagle <joshuaheagle@gmail.com>
+ * @class
+ */
+class HTMLCollectionService {
+  /**
+   * @param {NodeService} owner The node whose element children this is a live view of
+   * @constructor
+   */
+  constructor (owner) {
+    this.owner = owner
+  }
+
+  /**
+   * The current element children of the owner, in order.
+   * @returns {Array<PseudoNode>}
+   */
+  elements () {
+    return Array.from(this.owner.childNodes).filter(node => node.nodeType === NodeService_1.NodeService.ELEMENT_NODE)
+  }
+
+  /**
+   * How many elements are in the collection right now.
+   * @returns {number}
+   */
+  get length () {
+    return this.elements().length
+  }
+
+  /**
+   * The element at the given index, or null when there is none.
+   * @param {number} index
+   * @returns {*}
+   */
+  item (index) {
+    return this.elements()[index] || null
+  }
+
+  /**
+   * The element whose id, or (failing that) whose name attribute, is the given value, or null when there is none.
+   * @param {string} name
+   * @returns {*}
+   */
+  namedItem (name) {
+    const elements = this.elements()
+    return elements.find(element => element.id === name) || elements.find(element => element.getAttribute('name') === name) || null
+  }
+
+  /**
+   * Iterate over the current element children.
+   * @returns {Iterator}
+   */
+  [Symbol.iterator] () {
+    return this.elements()[Symbol.iterator]()
+  }
+}
 exports.HTMLCollectionService = HTMLCollectionService
+exports.default = HTMLCollectionService

package/dist/services/HTMLCollectionService.min.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.HTMLCollectionService=void 0;class HTMLCollectionService{}exports.HTMLCollectionService=HTMLCollectionService;
+"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;

package/dist/services/NodeService.d.ts

@@ -36,7 +36,8 @@ export declare class NodeService extends EventTargetService implements PseudoNod
     static readonly DOCUMENT_POSITION_CONTAINED_BY = 16;
     static readonly DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC = 32;
     private static nextNodeId;
-    children: PseudoNodeList | LinkedTreeList;
+    /** The raw list of every child node (all types), used to implement childNodes/firstChild/lastChild/insertBefore/removeChild. Not the same thing as Element.children (an HTMLCollection of just the element children). */
+    protected childList: PseudoNodeList | LinkedTreeList;
     parent: PseudoNode | null;
     protected nodeNameValue: string;
     private nodeValueStore;
@@ -91,6 +92,53 @@ export declare class NodeService extends EventTargetService implements PseudoNod
      * @returns {boolean}
      */
     protected equalsShallow(other: NodeService): boolean;
+    /**
+     * Add nodes (strings become text nodes) as the last children of this node, in the order given.
+     * @param {...(PseudoNode|string)} nodes The nodes (or text) to add
+     * @throws {Error} When this kind of node cannot have children
+     */
+    append(...nodes: Array<PseudoNode | string>): void;
+    /**
+     * Add nodes (strings become text nodes) as the first children of this node, in the order given.
+     * @param {...(PseudoNode|string)} nodes The nodes (or text) to add
+     * @throws {Error} When this kind of node cannot have children
+     */
+    prepend(...nodes: Array<PseudoNode | string>): void;
+    /**
+     * Remove every child of this node and put the given nodes (strings become text nodes) in their place, in order.
+     * @param {...(PseudoNode|string)} nodes The nodes (or text) to add
+     * @throws {Error} When this kind of node cannot have children
+     */
+    replaceChildren(...nodes: Array<PseudoNode | string>): void;
+    /**
+     * Add nodes (strings become text nodes) as this node's previous siblings, in order. Does nothing when this node has
+     * no parent.
+     * @param {...(PseudoNode|string)} nodes The nodes (or text) to add
+     */
+    before(...nodes: Array<PseudoNode | string>): void;
+    /**
+     * Add nodes (strings become text nodes) as this node's next siblings, in order. Does nothing when this node has no
+     * parent.
+     * @param {...(PseudoNode|string)} nodes The nodes (or text) to add
+     */
+    after(...nodes: Array<PseudoNode | string>): void;
+    /**
+     * Put the given nodes (strings become text nodes) where this node is, in order, then remove this node. Does nothing
+     * when this node has no parent.
+     * @param {...(PseudoNode|string)} nodes The nodes (or text) to put in this node's place
+     */
+    replaceWith(...nodes: Array<PseudoNode | string>): void;
+    /**
+     * Remove this node from its parent. Does nothing when it has no parent.
+     */
+    remove(): void;
+    /**
+     * Turn a value given to append / prepend / before / after / replaceWith / replaceChildren into a node: a string
+     * becomes a text node belonging to this node's document, anything else is returned as it is.
+     * @param {PseudoNode|string} value The value to add
+     * @returns {PseudoNode}
+     */
+    private toChildNode;
     /**
      * Called each time a node has been inserted as a child of this node, so that nodes which need to react to children
      * (for example elements applying default events) can do so.