pseudo-dom 0.7.0 → 0.9.0

package/dist/factories/cssSelectAdapter.js

@@ -1,87 +1,87 @@
-'use strict'
-
-require('core-js/modules/esnext.iterator.constructor.js')
-require('core-js/modules/esnext.iterator.filter.js')
-require('core-js/modules/esnext.iterator.for-each.js')
-require('core-js/modules/esnext.iterator.some.js')
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.cssSelectAdapter = void 0
-/**
- * @file The css-select Adapter which lets it query pseudo-dom's own tree, instead of the domutils-based tree it
- * defaults to.
- * @author Joshua Heagle <joshuaheagle@gmail.com>
- * @version 1.0.0
- */
-const NodeService_1 = require('../services/NodeService')
-/**
- * Walk up from a node (not including it) to find the nearest element, in the given direction.
- * @param {*} node The node to start from
- * @param {'nextSibling'|'previousSibling'} direction Which sibling reference to follow
- * @returns {*|null}
- */
-const nearestElementSibling = (node, direction) => {
-  let current = node ? node[direction] : null
-  while (current && current.nodeType !== NodeService_1.NodeService.ELEMENT_NODE) {
-    current = current[direction]
-  }
-  return current || null
-}
-/**
- * Maps pseudo-dom's own Node / Element API onto the Adapter interface css-select needs to query a tree which is not
- * domutils' own (css-select's own Adapter<Node, ElementNode> type). Every method here is one pseudo-dom already has
- * under a different name; nothing here reimplements DOM behaviour.
- * @memberOf module:factories
- * @type {Object}
- */
-exports.cssSelectAdapter = {
-  isTag: node => !!node && node.nodeType === NodeService_1.NodeService.ELEMENT_NODE,
-  existsOne: (test, elems) => elems.some(elem => exports.cssSelectAdapter.isTag(elem) && (test(elem) || exports.cssSelectAdapter.existsOne(test, exports.cssSelectAdapter.getChildren(elem)))),
-  // pseudo-dom's className / classList are kept in sync with each other, but not with a literal 'class' attribute
-  // (there is no such special-cased attribute here, unlike a real DOM) - so the 'class' css-select needs for class
-  // selectors is read from className instead.
-  getAttributeValue: (elem, name) => {
-    const value = name === 'class' ? elem.className : elem.getAttribute(name)
-    return value === null || value === undefined ? undefined : value
-  },
-  getChildren: node => Array.from(node.childNodes),
-  getName: elem => elem.tagName,
-  getParent: node => node.parentNode,
-  // Unlike jQuery's siblings(), this is expected to include the node itself
-  getSiblings: node => node.parentNode ? Array.from(node.parentNode.childNodes) : [node],
-  prevElementSibling: node => nearestElementSibling(node, 'previousSibling'),
-  getText: node => node.textContent || '',
-  hasAttrib: (elem, name) => elem.hasAttribute(name),
-  removeSubsets: nodes => nodes.filter((node, index) => !nodes.some((other, otherIndex) => otherIndex !== index && typeof other.contains === 'function' && other !== node && other.contains(node))),
-  findAll: (test, nodes) => {
-    const found = []
-    const visit = list => list.forEach(node => {
-      if (!exports.cssSelectAdapter.isTag(node)) {
-        return
-      }
-      if (test(node)) {
-        found.push(node)
-      }
-      visit(exports.cssSelectAdapter.getChildren(node))
-    })
-    visit(nodes)
-    return found
-  },
-  findOne: (test, nodes) => {
-    for (const node of nodes) {
-      if (!exports.cssSelectAdapter.isTag(node)) {
-        continue
-      }
-      if (test(node)) {
-        return node
-      }
-      const inChildren = exports.cssSelectAdapter.findOne(test, exports.cssSelectAdapter.getChildren(node))
-      if (inChildren) {
-        return inChildren
-      }
-    }
-    return null
-  }
-}
-exports.default = exports.cssSelectAdapter
+'use strict'
+
+require('core-js/modules/esnext.iterator.constructor.js')
+require('core-js/modules/esnext.iterator.filter.js')
+require('core-js/modules/esnext.iterator.for-each.js')
+require('core-js/modules/esnext.iterator.some.js')
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.cssSelectAdapter = void 0
+/**
+ * @file The css-select Adapter which lets it query pseudo-dom's own tree, instead of the domutils-based tree it
+ * defaults to.
+ * @author Joshua Heagle <joshuaheagle@gmail.com>
+ * @version 1.0.0
+ */
+const NodeService_1 = require('../services/NodeService')
+/**
+ * Walk up from a node (not including it) to find the nearest element, in the given direction.
+ * @param {*} node The node to start from
+ * @param {'nextSibling'|'previousSibling'} direction Which sibling reference to follow
+ * @returns {*|null}
+ */
+const nearestElementSibling = (node, direction) => {
+  let current = node ? node[direction] : null
+  while (current && current.nodeType !== NodeService_1.NodeService.ELEMENT_NODE) {
+    current = current[direction]
+  }
+  return current || null
+}
+/**
+ * Maps pseudo-dom's own Node / Element API onto the Adapter interface css-select needs to query a tree which is not
+ * domutils' own (css-select's own Adapter<Node, ElementNode> type). Every method here is one pseudo-dom already has
+ * under a different name; nothing here reimplements DOM behaviour.
+ * @memberOf module:factories
+ * @type {Object}
+ */
+exports.cssSelectAdapter = {
+  isTag: node => !!node && node.nodeType === NodeService_1.NodeService.ELEMENT_NODE,
+  existsOne: (test, elems) => elems.some(elem => exports.cssSelectAdapter.isTag(elem) && (test(elem) || exports.cssSelectAdapter.existsOne(test, exports.cssSelectAdapter.getChildren(elem)))),
+  // pseudo-dom's className / classList are kept in sync with each other, but not with a literal 'class' attribute
+  // (there is no such special-cased attribute here, unlike a real DOM) - so the 'class' css-select needs for class
+  // selectors is read from className instead.
+  getAttributeValue: (elem, name) => {
+    const value = name === 'class' ? elem.className : elem.getAttribute(name)
+    return value === null || value === undefined ? undefined : value
+  },
+  getChildren: node => Array.from(node.childNodes),
+  getName: elem => elem.tagName,
+  getParent: node => node.parentNode,
+  // Unlike jQuery's siblings(), this is expected to include the node itself
+  getSiblings: node => node.parentNode ? Array.from(node.parentNode.childNodes) : [node],
+  prevElementSibling: node => nearestElementSibling(node, 'previousSibling'),
+  getText: node => node.textContent || '',
+  hasAttrib: (elem, name) => elem.hasAttribute(name),
+  removeSubsets: nodes => nodes.filter((node, index) => !nodes.some((other, otherIndex) => otherIndex !== index && typeof other.contains === 'function' && other !== node && other.contains(node))),
+  findAll: (test, nodes) => {
+    const found = []
+    const visit = list => list.forEach(node => {
+      if (!exports.cssSelectAdapter.isTag(node)) {
+        return
+      }
+      if (test(node)) {
+        found.push(node)
+      }
+      visit(exports.cssSelectAdapter.getChildren(node))
+    })
+    visit(nodes)
+    return found
+  },
+  findOne: (test, nodes) => {
+    for (const node of nodes) {
+      if (!exports.cssSelectAdapter.isTag(node)) {
+        continue
+      }
+      if (test(node)) {
+        return node
+      }
+      const inChildren = exports.cssSelectAdapter.findOne(test, exports.cssSelectAdapter.getChildren(node))
+      if (inChildren) {
+        return inChildren
+      }
+    }
+    return null
+  }
+}
+exports.default = exports.cssSelectAdapter

package/dist/factories/query.d.ts

@@ -1,33 +1,33 @@
-/**
- * All of the elements below (not including) scope which match the selector, in tree order.
- * @memberOf module:factories
- * @param {string} selector A CSS selector
- * @param {*} scope The node to search below
- * @returns {Array<*>}
- */
-export declare const querySelectorAll: (selector: string, scope: any) => Array<any>;
-/**
- * The first element below (not including) scope which matches the selector, in tree order, or null when there is none.
- * @memberOf module:factories
- * @param {string} selector A CSS selector
- * @param {*} scope The node to search below
- * @returns {*|null}
- */
-export declare const querySelector: (selector: string, scope: any) => any | null;
-/**
- * Whether an element itself (not its descendants) matches the selector.
- * @memberOf module:factories
- * @param {*} element The element to test
- * @param {string} selector A CSS selector
- * @returns {boolean}
- */
-export declare const matches: (element: any, selector: string) => boolean;
-/**
- * The nearest ancestor of an element (starting with the element itself) which matches the selector, or null when
- * none of them do.
- * @memberOf module:factories
- * @param {*} element The element to start from
- * @param {string} selector A CSS selector
- * @returns {*|null}
- */
-export declare const closest: (element: any, selector: string) => any | null;
+/**
+ * All of the elements below (not including) scope which match the selector, in tree order.
+ * @memberOf module:factories
+ * @param {string} selector A CSS selector
+ * @param {*} scope The node to search below
+ * @returns {Array<*>}
+ */
+export declare const querySelectorAll: (selector: string, scope: any) => Array<any>;
+/**
+ * The first element below (not including) scope which matches the selector, in tree order, or null when there is none.
+ * @memberOf module:factories
+ * @param {string} selector A CSS selector
+ * @param {*} scope The node to search below
+ * @returns {*|null}
+ */
+export declare const querySelector: (selector: string, scope: any) => any | null;
+/**
+ * Whether an element itself (not its descendants) matches the selector.
+ * @memberOf module:factories
+ * @param {*} element The element to test
+ * @param {string} selector A CSS selector
+ * @returns {boolean}
+ */
+export declare const matches: (element: any, selector: string) => boolean;
+/**
+ * The nearest ancestor of an element (starting with the element itself) which matches the selector, or null when
+ * none of them do.
+ * @memberOf module:factories
+ * @param {*} element The element to start from
+ * @param {string} selector A CSS selector
+ * @returns {*|null}
+ */
+export declare const closest: (element: any, selector: string) => any | null;

package/dist/factories/query.js

@@ -1,66 +1,66 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.closest = exports.matches = exports.querySelector = exports.querySelectorAll = void 0
-/**
- * @file Selector queries (querySelector, querySelectorAll, matches, closest), built on css-select and the
- * cssSelectAdapter which lets it query pseudo-dom's own tree.
- * @author Joshua Heagle <joshuaheagle@gmail.com>
- * @version 1.0.0
- */
-const css_select_1 = require('css-select')
-const cssSelectAdapter_1 = require('./cssSelectAdapter')
-/**
- * All of the elements below (not including) scope which match the selector, in tree order.
- * @memberOf module:factories
- * @param {string} selector A CSS selector
- * @param {*} scope The node to search below
- * @returns {Array<*>}
- */
-const querySelectorAll = (selector, scope) => (0, css_select_1.selectAll)(selector, scope, {
-  adapter: cssSelectAdapter_1.cssSelectAdapter
-})
-exports.querySelectorAll = querySelectorAll
-/**
- * The first element below (not including) scope which matches the selector, in tree order, or null when there is none.
- * @memberOf module:factories
- * @param {string} selector A CSS selector
- * @param {*} scope The node to search below
- * @returns {*|null}
- */
-const querySelector = (selector, scope) => (0, css_select_1.selectOne)(selector, scope, {
-  adapter: cssSelectAdapter_1.cssSelectAdapter
-})
-exports.querySelector = querySelector
-/**
- * Whether an element itself (not its descendants) matches the selector.
- * @memberOf module:factories
- * @param {*} element The element to test
- * @param {string} selector A CSS selector
- * @returns {boolean}
- */
-const matches = (element, selector) => (0, css_select_1.is)(element, selector, {
-  adapter: cssSelectAdapter_1.cssSelectAdapter
-})
-exports.matches = matches
-/**
- * The nearest ancestor of an element (starting with the element itself) which matches the selector, or null when
- * none of them do.
- * @memberOf module:factories
- * @param {*} element The element to start from
- * @param {string} selector A CSS selector
- * @returns {*|null}
- */
-const closest = (element, selector) => {
-  let current = element
-  while (current && cssSelectAdapter_1.cssSelectAdapter.isTag(current)) {
-    if ((0, exports.matches)(current, selector)) {
-      return current
-    }
-    current = current.parentNode
-  }
-  return null
-}
-exports.closest = closest
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.closest = exports.matches = exports.querySelector = exports.querySelectorAll = void 0
+/**
+ * @file Selector queries (querySelector, querySelectorAll, matches, closest), built on css-select and the
+ * cssSelectAdapter which lets it query pseudo-dom's own tree.
+ * @author Joshua Heagle <joshuaheagle@gmail.com>
+ * @version 1.0.0
+ */
+const css_select_1 = require('css-select')
+const cssSelectAdapter_1 = require('./cssSelectAdapter')
+/**
+ * All of the elements below (not including) scope which match the selector, in tree order.
+ * @memberOf module:factories
+ * @param {string} selector A CSS selector
+ * @param {*} scope The node to search below
+ * @returns {Array<*>}
+ */
+const querySelectorAll = (selector, scope) => (0, css_select_1.selectAll)(selector, scope, {
+  adapter: cssSelectAdapter_1.cssSelectAdapter
+})
+exports.querySelectorAll = querySelectorAll
+/**
+ * The first element below (not including) scope which matches the selector, in tree order, or null when there is none.
+ * @memberOf module:factories
+ * @param {string} selector A CSS selector
+ * @param {*} scope The node to search below
+ * @returns {*|null}
+ */
+const querySelector = (selector, scope) => (0, css_select_1.selectOne)(selector, scope, {
+  adapter: cssSelectAdapter_1.cssSelectAdapter
+})
+exports.querySelector = querySelector
+/**
+ * Whether an element itself (not its descendants) matches the selector.
+ * @memberOf module:factories
+ * @param {*} element The element to test
+ * @param {string} selector A CSS selector
+ * @returns {boolean}
+ */
+const matches = (element, selector) => (0, css_select_1.is)(element, selector, {
+  adapter: cssSelectAdapter_1.cssSelectAdapter
+})
+exports.matches = matches
+/**
+ * The nearest ancestor of an element (starting with the element itself) which matches the selector, or null when
+ * none of them do.
+ * @memberOf module:factories
+ * @param {*} element The element to start from
+ * @param {string} selector A CSS selector
+ * @returns {*|null}
+ */
+const closest = (element, selector) => {
+  let current = element
+  while (current && cssSelectAdapter_1.cssSelectAdapter.isTag(current)) {
+    if ((0, exports.matches)(current, selector)) {
+      return current
+    }
+    current = current.parentNode
+  }
+  return null
+}
+exports.closest = closest

package/dist/functions/getElementById.d.ts

@@ -0,0 +1,13 @@
+import { NodeService } from '../services/NodeService';
+import { PseudoElement } from '../interfaces/PseudoElement';
+/**
+ * The first element, in tree order, below (not including) the given node whose id matches the given value, or null
+ * when there is none. Shared by Document and DocumentFragment, which both implement the DOM's NonElementParentNode
+ * mixin (so ShadowRoot, a DocumentFragment, gets it too).
+ * @memberOf module:functions
+ * @param {NodeService} root The node to search below
+ * @param {string} id
+ * @returns {PseudoElement|null}
+ */
+declare const getElementById: (root: NodeService, id: string) => PseudoElement | null;
+export default getElementById;

package/dist/functions/getElementById.js

@@ -0,0 +1,33 @@
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+const NodeService_1 = require('../services/NodeService')
+/**
+ * The first element, in tree order, below (not including) the given node whose id matches the given value, or null
+ * when there is none. Shared by Document and DocumentFragment, which both implement the DOM's NonElementParentNode
+ * mixin (so ShadowRoot, a DocumentFragment, gets it too).
+ * @memberOf module:functions
+ * @param {NodeService} root The node to search below
+ * @param {string} id
+ * @returns {PseudoElement|null}
+ */
+const getElementById = (root, id) => {
+  const search = node => {
+    for (const child of Array.from(node.childNodes)) {
+      if (child.nodeType === NodeService_1.NodeService.ELEMENT_NODE) {
+        if (child.id === id) {
+          return child
+        }
+        const found = search(child)
+        if (found) {
+          return found
+        }
+      }
+    }
+    return null
+  }
+  return search(root)
+}
+exports.default = getElementById

package/dist/functions/getElementById.min.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});const NodeService_1=require("../services/NodeService"),getElementById=(e,r)=>{const t=e=>{for(const o of Array.from(e.childNodes))if(o.nodeType===NodeService_1.NodeService.ELEMENT_NODE){if(o.id===r)return o;const e=t(o);if(e)return e}return null};return t(e)};exports.default=getElementById;

package/dist/interfaces/PseudoCSSStyleDeclaration.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @file Substitute for the DOM CSSStyleDeclaration Class. Real instances (from createStyleDeclaration) also accept
+ * arbitrary camelCase CSS property names (declaration.backgroundColor), which cannot be expressed in an interface.
+ */
+export interface PseudoCSSStyleDeclaration {
+    get length(): number;
+    get cssText(): string;
+    set cssText(cssText: string);
+    item(index: number): string;
+    getPropertyValue(property: string): string;
+    getPropertyPriority(property: string): string;
+    setProperty(property: string, value: string, priority: string): void;
+    removeProperty(property: string): string;
+}

package/dist/interfaces/PseudoCSSStyleDeclaration.js

@@ -0,0 +1,5 @@
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})

package/dist/interfaces/PseudoCSSStyleDeclaration.min.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});

package/dist/interfaces/PseudoDocument.d.ts

@@ -1,10 +1,35 @@
-import { PseudoNode } from './PseudoNode';
-import { PseudoElement } from './PseudoElement';
-export interface PseudoDocument extends PseudoNode {
-    /**
-     * The first element, in tree order, whose id matches the given value, or null when there is none.
-     * @param {string} id
-     * @returns {PseudoElement|null}
-     */
-    getElementById(id: string): PseudoElement | null;
-}
+import { PseudoNode } from './PseudoNode';
+import { PseudoElement } from './PseudoElement';
+import { PseudoDocumentFragment } from './PseudoDocumentFragment';
+export interface PseudoDocument extends PseudoNode {
+    /**
+     * The first element, in tree order, whose id matches the given value, or null when there is none.
+     * @param {string} id
+     * @returns {PseudoElement|null}
+     */
+    getElementById(id: string): PseudoElement | null;
+    /**
+     * Make an element of the given type which belongs to this document but is not added anywhere until it is appended.
+     * @param {string} [tagName='div'] The type of element to create
+     * @returns {PseudoElement}
+     */
+    createElement(tagName: string): PseudoElement;
+    /**
+     * Make a text node which belongs to this document.
+     * @param {string} [data=''] The text
+     * @returns {PseudoNode}
+     */
+    createTextNode(data: string): PseudoNode;
+    /**
+     * Make a comment which belongs to this document.
+     * @param {string} [data=''] The comment
+     * @returns {PseudoNode}
+     */
+    createComment(data: string): PseudoNode;
+    /**
+     * Make an empty document fragment which belongs to this document, a container for nodes which can be built up and
+     * then inserted in one go.
+     * @returns {PseudoDocumentFragment}
+     */
+    createDocumentFragment(): PseudoDocumentFragment;
+}

package/dist/interfaces/PseudoDocumentFragment.d.ts

@@ -1,3 +1,10 @@
 import { PseudoNode } from './PseudoNode';
+import { PseudoElement } from './PseudoElement';
 export interface PseudoDocumentFragment extends PseudoNode {
+    /**
+     * The first element, in tree order, whose id matches the given value, or null when there is none.
+     * @param {string} id
+     * @returns {PseudoElement|null}
+     */
+    getElementById(id: string): PseudoElement | null;
 }