treeloom 0.0.0-stage → 2.1.0

package/dist/domItem/objects/initChildren.js

@@ -0,0 +1,44 @@
+"use strict";
+
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+var __importDefault = void 0 && (void 0).__importDefault || function (mod) {
+  return mod && mod.__esModule ? mod : {
+    "default": mod
+  };
+};
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+const createDomItem_1 = __importDefault(require("./createDomItem"));
+const onBodyLoad_1 = __importDefault(require("si-funciona/dist/helpers/functions/onBodyLoad"));
+/**
+ * Initiate the children of Root / DocumentItem. This is a helper for {@link documentDomItem}.
+ */
+const initChildren = () => {
+  const head = document.head;
+  const body = document.body;
+  const children = [(0, createDomItem_1.default)({
+    nodeName: 'head',
+    attributes: {},
+    element: head,
+    children: []
+  }), (0, createDomItem_1.default)({
+    nodeName: 'body',
+    attributes: {},
+    element: body,
+    children: []
+  })];
+  if (!head || !body) {
+    (0, onBodyLoad_1.default)(() => {
+      if (children[1].element === null) {
+        children[0].element = document.head;
+        children[1].element = document.body;
+      }
+      return children;
+    });
+  }
+  return children;
+};
+exports.default = initChildren;

package/dist/domItem/objects/initChildren.min.js

@@ -0,0 +1 @@
+"use strict";var __importDefault=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const createDomItem_1=__importDefault(require("./createDomItem")),onBodyLoad_1=__importDefault(require("si-funciona/dist/helpers/functions/onBodyLoad")),initChildren=()=>{const e=document.head,t=document.body,o=[(0,createDomItem_1.default)({nodeName:"head",attributes:{},element:e,children:[]}),(0,createDomItem_1.default)({nodeName:"body",attributes:{},element:t,children:[]})];return e&&t||(0,onBodyLoad_1.default)(()=>(null===o[1].element&&(o[0].element=document.head,o[1].element=document.body),o)),o};exports.default=initChildren;

package/dist/domItem/objects/initRoot.d.ts

@@ -0,0 +1,9 @@
+import type { DomItem, DomItemRoot } from '../types';
+import type { ListenerFunction } from '../../events/types';
+/**
+ * Initiate the Root for DocumentItem. This is primary a helper for {@link documentDomItem}.
+ * @param children - Provide an array of Head and Body (usually via {@link initChildren})
+ * @param listeners - An object of all event listeners to be registered in the Dom
+ */
+declare const initRoot: (children?: DomItem[], listeners?: Record<string, ListenerFunction>) => DomItemRoot;
+export default initRoot;

package/dist/domItem/objects/initRoot.js

@@ -0,0 +1,32 @@
+"use strict";
+
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+var __importDefault = void 0 && (void 0).__importDefault || function (mod) {
+  return mod && mod.__esModule ? mod : {
+    "default": mod
+  };
+};
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+const createDomItem_1 = __importDefault(require("./createDomItem"));
+/**
+ * Initiate the Root for DocumentItem. This is primary a helper for {@link documentDomItem}.
+ * @param children - Provide an array of Head and Body (usually via {@link initChildren})
+ * @param listeners - An object of all event listeners to be registered in the Dom
+ */
+const initRoot = (children = [{}, {}], listeners = {}) => (0, createDomItem_1.default)({
+  nodeName: '#document',
+  nodeValue: null,
+  attributes: {},
+  element: document,
+  eventActions: listeners,
+  eventListeners: {},
+  children,
+  parentItem: {},
+  head: children[0],
+  body: children[1]
+});
+exports.default = initRoot;

package/dist/domItem/objects/initRoot.min.js

@@ -0,0 +1 @@
+"use strict";var __importDefault=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const createDomItem_1=__importDefault(require("./createDomItem")),initRoot=(e=[{},{}],t={})=>(0,createDomItem_1.default)({nodeName:"#document",nodeValue:null,attributes:{},element:document,eventActions:t,eventListeners:{},children:e,parentItem:{},head:e[0],body:e[1]});exports.default=initRoot;

package/dist/domItem/query/gatherChildItems.d.ts

@@ -0,0 +1,12 @@
+import type { ChildTest, DomItem } from '../types';
+/**
+ * A selector function for retrieving existing child domGeneral.DomItems from the given parent item.
+ * This function will check all the children starting from and including item, and run the test function on each
+ * child encountered. The return array contains children returned from the test from all levels.
+ * WARNING: This is a recursive function.
+ * @param item - The DomItem which may have child items matching the attribute
+ * criteria
+ * @param test - Assess each child, and return the ones which qualify
+ */
+declare const gatherChildItems: (item: DomItem, test: ChildTest) => DomItem[];
+export default gatherChildItems;

package/dist/domItem/query/gatherChildItems.js

@@ -0,0 +1,19 @@
+"use strict";
+
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+/**
+ * A selector function for retrieving existing child domGeneral.DomItems from the given parent item.
+ * This function will check all the children starting from and including item, and run the test function on each
+ * child encountered. The return array contains children returned from the test from all levels.
+ * WARNING: This is a recursive function.
+ * @param item - The DomItem which may have child items matching the attribute
+ * criteria
+ * @param test - Assess each child, and return the ones which qualify
+ */
+const gatherChildItems = (item, test) => test(item, item.children.reduce((a, b) => a.concat(gatherChildItems(b, test)), []));
+exports.default = gatherChildItems;

package/dist/domItem/query/gatherChildItems.min.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});const gatherChildItems=(e,t)=>t(e,e.children.reduce((e,r)=>e.concat(gatherChildItems(r,t)),[]));exports.default=gatherChildItems;

package/dist/domItem/query/getChildTest.d.ts

@@ -0,0 +1,8 @@
+import type { ChildTest } from '../types';
+/**
+ * Retrieve the {@link module:domGeneral~testChildItem} function by providing an attribute and value to check.
+ * @param attr - Provide the attribute name to be searched
+ * @param value - The attribute value to be compared
+ */
+declare const getChildTest: (attr: string, value: unknown) => ChildTest;
+export default getChildTest;

package/dist/domItem/query/getChildTest.js

@@ -0,0 +1,15 @@
+"use strict";
+
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+/**
+ * Retrieve the {@link module:domGeneral~testChildItem} function by providing an attribute and value to check.
+ * @param attr - Provide the attribute name to be searched
+ * @param value - The attribute value to be compared
+ */
+const getChildTest = (attr, value) => (item, gatheredResults) => item.attributes[attr] && item.attributes[attr] === value ? gatheredResults.concat([item]) : gatheredResults;
+exports.default = getChildTest;

package/dist/domItem/query/getChildTest.min.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});const getChildTest=(t,e)=>(s,r)=>s.attributes[t]&&s.attributes[t]===e?r.concat([s]):r;exports.default=getChildTest;

package/dist/domItem/query/getChildrenByClass.d.ts

@@ -0,0 +1,11 @@
+import type { DomItem } from '../types';
+/**
+ * Helper for getting all domGeneral.DomItems starting at item and carrying the given class, among possibly several
+ * space-separated classes on that item - the same membership check as the real DOM's classList.contains, not an
+ * exact match of the whole className attribute string (which getChildrenFromAttribute does, and which would miss
+ * an item that also carries other classes).
+ * @param className - The one class being searched for
+ * @param item - The DomItem which may have child items carrying the class
+ */
+declare const getChildrenByClass: (className: string, item?: DomItem) => DomItem[];
+export default getChildrenByClass;

package/dist/domItem/query/getChildrenByClass.js

@@ -0,0 +1,26 @@
+"use strict";
+
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+require("core-js/modules/es.array.includes.js");
+var __importDefault = void 0 && (void 0).__importDefault || function (mod) {
+  return mod && mod.__esModule ? mod : {
+    "default": mod
+  };
+};
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+const documentItem_1 = __importDefault(require("../objects/documentItem"));
+const gatherChildItems_1 = __importDefault(require("./gatherChildItems"));
+/**
+ * Helper for getting all domGeneral.DomItems starting at item and carrying the given class, among possibly several
+ * space-separated classes on that item - the same membership check as the real DOM's classList.contains, not an
+ * exact match of the whole className attribute string (which getChildrenFromAttribute does, and which would miss
+ * an item that also carries other classes).
+ * @param className - The one class being searched for
+ * @param item - The DomItem which may have child items carrying the class
+ */
+const getChildrenByClass = (className, item = (0, documentItem_1.default)().body) => (0, gatherChildItems_1.default)(item, (child, gatheredResults) => (child.attributes.className ?? '').split(' ').includes(className) ? gatheredResults.concat([child]) : gatheredResults);
+exports.default = getChildrenByClass;

package/dist/domItem/query/getChildrenByClass.min.js

@@ -0,0 +1 @@
+"use strict";require("core-js/modules/es.array.includes.js");var __importDefault=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const documentItem_1=__importDefault(require("../objects/documentItem")),gatherChildItems_1=__importDefault(require("./gatherChildItems")),getChildrenByClass=(e,t=(0,documentItem_1.default)().body)=>(0,gatherChildItems_1.default)(t,(t,r)=>(t.attributes.className??"").split(" ").includes(e)?r.concat([t]):r);exports.default=getChildrenByClass;

package/dist/domItem/query/getChildrenByName.d.ts

@@ -0,0 +1,9 @@
+import type { DomItem } from '../types';
+/**
+ * Helper for getting all domGeneral.DomItems starting at parent and having specified name attribute
+ * @param name - The name searched for
+ * @param item - The DomItem which may have child items matching the attribute
+ * criteria
+ */
+declare const getChildrenByName: (name: string, item?: DomItem) => DomItem[];
+export default getChildrenByName;

package/dist/domItem/query/getChildrenByName.js

@@ -0,0 +1,23 @@
+"use strict";
+
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+var __importDefault = void 0 && (void 0).__importDefault || function (mod) {
+  return mod && mod.__esModule ? mod : {
+    "default": mod
+  };
+};
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+const si_funciona_1 = __importDefault(require("si-funciona"));
+const getChildrenFromAttribute_1 = __importDefault(require("./getChildrenFromAttribute"));
+/**
+ * Helper for getting all domGeneral.DomItems starting at parent and having specified name attribute
+ * @param name - The name searched for
+ * @param item - The DomItem which may have child items matching the attribute
+ * criteria
+ */
+const getChildrenByName = si_funciona_1.default.curry(getChildrenFromAttribute_1.default)('name');
+exports.default = getChildrenByName;

package/dist/domItem/query/getChildrenByName.min.js

@@ -0,0 +1 @@
+"use strict";var __importDefault=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const si_funciona_1=__importDefault(require("si-funciona")),getChildrenFromAttribute_1=__importDefault(require("./getChildrenFromAttribute")),getChildrenByName=si_funciona_1.default.curry(getChildrenFromAttribute_1.default)("name");exports.default=getChildrenByName;

package/dist/domItem/query/getChildrenFromAttribute.d.ts

@@ -0,0 +1,13 @@
+import type { DomItem } from '../types';
+/**
+ * A selector function for retrieving existing child domGeneral.DomItems from the given parent item.
+ * This function will check all the children starting from item, and scan the attributes
+ * property for matches. The returned array contains children matching from all levels.
+ * WARNING: This calls a recursive function.
+ * @param attr - Provide the attribute name to be searched
+ * @param value - The attribute value to be compared
+ * @param item - The DomItem which may have child items matching the attribute
+ * criteria
+ */
+declare const getChildrenFromAttribute: (attr: string, value: unknown, item?: DomItem) => DomItem[];
+export default getChildrenFromAttribute;

package/dist/domItem/query/getChildrenFromAttribute.js

@@ -0,0 +1,28 @@
+"use strict";
+
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+var __importDefault = void 0 && (void 0).__importDefault || function (mod) {
+  return mod && mod.__esModule ? mod : {
+    "default": mod
+  };
+};
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+const documentItem_1 = __importDefault(require("../objects/documentItem"));
+const gatherChildItems_1 = __importDefault(require("./gatherChildItems"));
+const getChildTest_1 = __importDefault(require("./getChildTest"));
+/**
+ * A selector function for retrieving existing child domGeneral.DomItems from the given parent item.
+ * This function will check all the children starting from item, and scan the attributes
+ * property for matches. The returned array contains children matching from all levels.
+ * WARNING: This calls a recursive function.
+ * @param attr - Provide the attribute name to be searched
+ * @param value - The attribute value to be compared
+ * @param item - The DomItem which may have child items matching the attribute
+ * criteria
+ */
+const getChildrenFromAttribute = (attr, value, item = (0, documentItem_1.default)().body) => (0, gatherChildItems_1.default)(item, (0, getChildTest_1.default)(attr, value));
+exports.default = getChildrenFromAttribute;

package/dist/domItem/query/getChildrenFromAttribute.min.js

@@ -0,0 +1 @@
+"use strict";var __importDefault=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const documentItem_1=__importDefault(require("../objects/documentItem")),gatherChildItems_1=__importDefault(require("./gatherChildItems")),getChildTest_1=__importDefault(require("./getChildTest")),getChildrenFromAttribute=(e,t,r=(0,documentItem_1.default)().body)=>(0,gatherChildItems_1.default)(r,(0,getChildTest_1.default)(e,t));exports.default=getChildrenFromAttribute;

package/dist/domItem/query/getItemByElement.d.ts

@@ -0,0 +1,11 @@
+import type { DomItem } from '../types';
+/**
+ * Find the item (item itself, or one of its descendants) whose element is the one given, or null when none match.
+ * Only searches item and its own subtree: an event's target is always the item a listener is attached to, or one of
+ * its descendants (that is what bubbling means), so there is never a reason to search outside it.
+ * WARNING: This is a recursive function.
+ * @param item - The DomItem (and its subtree) to search.
+ * @param element - The real element to match against each item's element.
+ */
+declare const getItemByElement: (item: DomItem, element: EventTarget | null) => DomItem | null;
+export default getItemByElement;

package/dist/domItem/query/getItemByElement.js

@@ -0,0 +1,29 @@
+"use strict";
+
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+/**
+ * Find the item (item itself, or one of its descendants) whose element is the one given, or null when none match.
+ * Only searches item and its own subtree: an event's target is always the item a listener is attached to, or one of
+ * its descendants (that is what bubbling means), so there is never a reason to search outside it.
+ * WARNING: This is a recursive function.
+ * @param item - The DomItem (and its subtree) to search.
+ * @param element - The real element to match against each item's element.
+ */
+const getItemByElement = (item, element) => {
+  if (item.element === element) {
+    return item;
+  }
+  for (const child of item.children) {
+    const found = getItemByElement(child, element);
+    if (found) {
+      return found;
+    }
+  }
+  return null;
+};
+exports.default = getItemByElement;

package/dist/domItem/query/getItemByElement.min.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});const getItemByElement=(e,t)=>{if(e.element===t)return e;for(const n of e.children){const e=getItemByElement(n,t);if(e)return e}return null};exports.default=getItemByElement;

package/dist/domItem/query/getParentsByClass.d.ts

@@ -0,0 +1,12 @@
+import type { DomItem } from '../types';
+/**
+ * Helper for getting all domGeneral.DomItems going up from item's parent, each one carrying the given class, among
+ * possibly several space-separated classes on that item - the same membership check as the real DOM's
+ * classList.contains, not an exact match of the whole className attribute string (which getParentsFromAttribute
+ * does, and which would miss a parent that also carries other classes).
+ * WARNING: This is a recursive function.
+ * @param className - The one class being searched for
+ * @param item - The DomItem which may have parent items carrying the class
+ */
+declare const getParentsByClass: (className: string, item?: DomItem) => DomItem[];
+export default getParentsByClass;

package/dist/domItem/query/getParentsByClass.js

@@ -0,0 +1,40 @@
+"use strict";
+
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+require("core-js/modules/es.array.includes.js");
+var __importDefault = void 0 && (void 0).__importDefault || function (mod) {
+  return mod && mod.__esModule ? mod : {
+    "default": mod
+  };
+};
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+const documentItem_1 = __importDefault(require("../objects/documentItem"));
+const si_funciona_1 = __importDefault(require("si-funciona"));
+/**
+ * Helper for getting all domGeneral.DomItems going up from item's parent, each one carrying the given class, among
+ * possibly several space-separated classes on that item - the same membership check as the real DOM's
+ * classList.contains, not an exact match of the whole className attribute string (which getParentsFromAttribute
+ * does, and which would miss a parent that also carries other classes).
+ * WARNING: This is a recursive function.
+ * @param className - The one class being searched for
+ * @param item - The DomItem which may have parent items carrying the class
+ */
+const getParentsByClass = (className, item = (0, documentItem_1.default)().body) => {
+  if (item.parentItem === null) {
+    if (item.nodeName === '#document') {
+      throw new Error('Root parent item must be an empty object, null reference found.');
+    }
+    throw new Error('Detached child, missing parentItem reference. Use empty object if this is the root item.');
+  }
+  if (si_funciona_1.default.emptyObject(item.parentItem)) {
+    return [];
+  }
+  const parent = item.parentItem;
+  const carriesClass = (parent.attributes.className ?? '').split(' ').includes(className);
+  return carriesClass ? getParentsByClass(className, parent).concat([parent]) : getParentsByClass(className, parent);
+};
+exports.default = getParentsByClass;

package/dist/domItem/query/getParentsByClass.min.js

@@ -0,0 +1 @@
+"use strict";require("core-js/modules/es.array.includes.js");var __importDefault=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const documentItem_1=__importDefault(require("../objects/documentItem")),si_funciona_1=__importDefault(require("si-funciona")),getParentsByClass=(e,t=(0,documentItem_1.default)().body)=>{if(null===t.parentItem){if("#document"===t.nodeName)throw new Error("Root parent item must be an empty object, null reference found.");throw new Error("Detached child, missing parentItem reference. Use empty object if this is the root item.")}if(si_funciona_1.default.emptyObject(t.parentItem))return[];const r=t.parentItem;return(r.attributes.className??"").split(" ").includes(e)?getParentsByClass(e,r).concat([r]):getParentsByClass(e,r)};exports.default=getParentsByClass;

package/dist/domItem/query/getParentsByName.d.ts

@@ -0,0 +1,9 @@
+import type { DomItem } from '../types';
+/**
+ * Helper for getting all domGeneral.DomItems starting at child and having specified name attribute
+ * @param name - The name to search for
+ * @param item - The DomItem which may have parent items matching the
+ * attribute criteria
+ */
+declare const getParentsByName: (name: string, item?: DomItem) => DomItem[];
+export default getParentsByName;

package/dist/domItem/query/getParentsByName.js

@@ -0,0 +1,23 @@
+"use strict";
+
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+var __importDefault = void 0 && (void 0).__importDefault || function (mod) {
+  return mod && mod.__esModule ? mod : {
+    "default": mod
+  };
+};
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+const si_funciona_1 = __importDefault(require("si-funciona"));
+const getParentsFromAttribute_1 = __importDefault(require("./getParentsFromAttribute"));
+/**
+ * Helper for getting all domGeneral.DomItems starting at child and having specified name attribute
+ * @param name - The name to search for
+ * @param item - The DomItem which may have parent items matching the
+ * attribute criteria
+ */
+const getParentsByName = si_funciona_1.default.curry(getParentsFromAttribute_1.default)('name');
+exports.default = getParentsByName;

package/dist/domItem/query/getParentsByName.min.js

@@ -0,0 +1 @@
+"use strict";var __importDefault=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const si_funciona_1=__importDefault(require("si-funciona")),getParentsFromAttribute_1=__importDefault(require("./getParentsFromAttribute")),getParentsByName=si_funciona_1.default.curry(getParentsFromAttribute_1.default)("name");exports.default=getParentsByName;

package/dist/domItem/query/getParentsByTagName.d.ts

@@ -0,0 +1,9 @@
+import type { DomItem } from '../types';
+/**
+ * Helper for getting all domGeneral.DomItems starting at child and having specified nodeName
+ * @param nodeName - The nodeName to search for
+ * @param item - The DomItem which may have parent items matching the
+ * attribute criteria
+ */
+declare const getParentsByTagName: (nodeName: string, item?: DomItem) => DomItem[];
+export default getParentsByTagName;

package/dist/domItem/query/getParentsByTagName.js

@@ -0,0 +1,23 @@
+"use strict";
+
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+var __importDefault = void 0 && (void 0).__importDefault || function (mod) {
+  return mod && mod.__esModule ? mod : {
+    "default": mod
+  };
+};
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+const si_funciona_1 = __importDefault(require("si-funciona"));
+const getParentsFromAttribute_1 = __importDefault(require("./getParentsFromAttribute"));
+/**
+ * Helper for getting all domGeneral.DomItems starting at child and having specified nodeName
+ * @param nodeName - The nodeName to search for
+ * @param item - The DomItem which may have parent items matching the
+ * attribute criteria
+ */
+const getParentsByTagName = si_funciona_1.default.curry(getParentsFromAttribute_1.default)('nodeName');
+exports.default = getParentsByTagName;

package/dist/domItem/query/getParentsByTagName.min.js

@@ -0,0 +1 @@
+"use strict";var __importDefault=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const si_funciona_1=__importDefault(require("si-funciona")),getParentsFromAttribute_1=__importDefault(require("./getParentsFromAttribute")),getParentsByTagName=si_funciona_1.default.curry(getParentsFromAttribute_1.default)("nodeName");exports.default=getParentsByTagName;

package/dist/domItem/query/getParentsFromAttribute.d.ts

@@ -0,0 +1,13 @@
+import type { DomItem } from '../types';
+/**
+ * A selector function for retrieving existing child domGeneral.DomItems from the given parent item.
+ * This function will check all the children starting from item, and scan the attributes
+ * property for matches. The return array contains children matching from all levels.
+ * WARNING: This is a recursive function.
+ * @param attr - Provide the attribute name to be searched
+ * @param value - The attribute value to be compared
+ * @param item - The DomItem which may have parent items matching the
+ * attribute criteria
+ */
+declare const getParentsFromAttribute: (attr: string, value: unknown, item?: DomItem) => DomItem[];
+export default getParentsFromAttribute;

package/dist/domItem/query/getParentsFromAttribute.js

@@ -0,0 +1,39 @@
+"use strict";
+
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+var __importDefault = void 0 && (void 0).__importDefault || function (mod) {
+  return mod && mod.__esModule ? mod : {
+    "default": mod
+  };
+};
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+const documentItem_1 = __importDefault(require("../objects/documentItem"));
+const si_funciona_1 = __importDefault(require("si-funciona"));
+/**
+ * A selector function for retrieving existing child domGeneral.DomItems from the given parent item.
+ * This function will check all the children starting from item, and scan the attributes
+ * property for matches. The return array contains children matching from all levels.
+ * WARNING: This is a recursive function.
+ * @param attr - Provide the attribute name to be searched
+ * @param value - The attribute value to be compared
+ * @param item - The DomItem which may have parent items matching the
+ * attribute criteria
+ */
+const getParentsFromAttribute = (attr, value, item = (0, documentItem_1.default)().body) => {
+  if (item.parentItem === null) {
+    if (item.nodeName === '#document') {
+      throw new Error('Root parent item must be an empty object, null reference found.');
+    }
+    throw new Error('Detached child, missing parentItem reference. Use empty object if this is the root item.');
+  }
+  if (si_funciona_1.default.emptyObject(item.parentItem)) {
+    return [];
+  }
+  const parent = item.parentItem;
+  return (parent.attributes[attr] || item[attr] || false) === value ? getParentsFromAttribute(attr, value, parent).concat([parent]) : getParentsFromAttribute(attr, value, parent);
+};
+exports.default = getParentsFromAttribute;

package/dist/domItem/query/getParentsFromAttribute.min.js

@@ -0,0 +1 @@
+"use strict";var __importDefault=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const documentItem_1=__importDefault(require("../objects/documentItem")),si_funciona_1=__importDefault(require("si-funciona")),getParentsFromAttribute=(e,t,r=(0,documentItem_1.default)().body)=>{if(null===r.parentItem){if("#document"===r.nodeName)throw new Error("Root parent item must be an empty object, null reference found.");throw new Error("Detached child, missing parentItem reference. Use empty object if this is the root item.")}if(si_funciona_1.default.emptyObject(r.parentItem))return[];const n=r.parentItem;return(n.attributes[e]||r[e]||!1)===t?getParentsFromAttribute(e,t,n).concat([n]):getParentsFromAttribute(e,t,n)};exports.default=getParentsFromAttribute;

package/dist/domItem/traits/defineTrait.d.ts

@@ -0,0 +1,10 @@
+import type { TraitDefinition } from '../types';
+/**
+ * Describe a trait so treeloom knows what it is at runtime: the properties it puts on an item (so they can be left out
+ * of json when they only make sense where the item lives), and the defaults a new item gets. Types are added
+ * separately, by merging into TraitRegistry.
+ * @param name - The name of the trait, prefixed by the package which defines it: matrix.row
+ * @param definition - The properties the trait puts on an item, whether they are serializable and the defaults.
+ */
+declare const defineTrait: (name: string, definition: TraitDefinition) => TraitDefinition;
+export default defineTrait;

package/dist/domItem/traits/defineTrait.js

@@ -0,0 +1,26 @@
+"use strict";
+
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+var __importDefault = void 0 && (void 0).__importDefault || function (mod) {
+  return mod && mod.__esModule ? mod : {
+    "default": mod
+  };
+};
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+const definitions_1 = __importDefault(require("./definitions"));
+/**
+ * Describe a trait so treeloom knows what it is at runtime: the properties it puts on an item (so they can be left out
+ * of json when they only make sense where the item lives), and the defaults a new item gets. Types are added
+ * separately, by merging into TraitRegistry.
+ * @param name - The name of the trait, prefixed by the package which defines it: matrix.row
+ * @param definition - The properties the trait puts on an item, whether they are serializable and the defaults.
+ */
+const defineTrait = (name, definition) => {
+  definitions_1.default.set(name, definition);
+  return definition;
+};
+exports.default = defineTrait;

package/dist/domItem/traits/defineTrait.min.js

@@ -0,0 +1 @@
+"use strict";var __importDefault=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const definitions_1=__importDefault(require("./definitions")),defineTrait=(e,t)=>(definitions_1.default.set(e,t),t);exports.default=defineTrait;

package/dist/domItem/traits/definitions.d.ts

@@ -0,0 +1,7 @@
+import type { TraitDefinition } from '../types';
+/**
+ * What each trait is at runtime, by name. render is the one treeloom brings; other libraries add theirs with
+ * defineTrait.
+ */
+declare const definitions: Map<string, TraitDefinition>;
+export default definitions;

package/dist/domItem/traits/definitions.js

@@ -0,0 +1,20 @@
+"use strict";
+
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+/**
+ * What each trait is at runtime, by name. render is the one treeloom brings; other libraries add theirs with
+ * defineTrait.
+ */
+const definitions = new Map([['render', {
+  keys: ['element', 'activeListeners'],
+  serializable: false,
+  defaults: () => ({
+    element: null
+  })
+}]]);
+exports.default = definitions;

package/dist/domItem/traits/definitions.min.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});const definitions=new Map([["render",{keys:["element","activeListeners"],serializable:!1,defaults:()=>({element:null})}]]);exports.default=definitions;

package/dist/domItem/traits/getNonSerializableKeys.d.ts

@@ -0,0 +1,9 @@
+import type { CoreItem } from '../types';
+/**
+ * The properties an item has only because of its traits, and which do not belong in json (the element of the render
+ * trait, for one).
+ * @param item - The item to look at.
+ * @private
+ */
+declare const getNonSerializableKeys: (item: CoreItem) => string[];
+export default getNonSerializableKeys;