pseudo-dom 0.7.0 → 0.8.0

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/PseudoDocument.d.ts

@@ -1,5 +1,6 @@
 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.
@@ -7,4 +8,28 @@ export interface PseudoDocument extends PseudoNode {
      * @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';
-export interface PseudoDocumentFragment extends PseudoNode {
-}
+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;
+}